English | 日本語
ホーム > Merge > Merge for Windows > ドキュメントの目次 > TextComparison オブジェクト

TextComparison オブジェクト

このオブジェクトは、テキスト ファイル比較ウィンドウを表します。ウィンドウは画面に表示されないことがあります。このウィンドウを使って、クライアントにファイル比較サービスを実行したり、ユーザーにファイル比較画面を表示することができます。

このオブジェクトが公開するメソッドとプロパティを使って、テキスト ファイル比較、結果の抽出、テキスト ファイル比較ウィンドウの外観の変更を行います。

プロパティ (ICommonUI インターフェイスによって実装されます )

Active

IDL [propget] HRESULT Active([out, retval] VARIANT_BOOL* pValue)
[propput] HRESULT Active([in] VARIANT_BOOL newValue)
.NET Boolean Active[get, set]
VB6 Active As Boolean

比較ウィンドウの作業状態。

このプロパティは 取得と設定が可能です。

Height

IDL [propget] HRESULT Height([out, retval] long* pValue)
[propput] HRESULT Height([in] long newValue)
.NET Int32 Height[get, set]
VB6 Height As Long

比較ウィンドウの高さ(ピクセル)。

このプロパティは 取得と設定が可能です。

Left

IDL [propget] HRESULT Left([out, retval] long* pValue)
[propput] HRESULT Left([in] long newValue)
.NET Int32 Left[get, set]
VB6 Left As Long

比較ウィンドウの左端のピクセル座標の位置。

このプロパティは 取得と設定が可能です。

Maximized

IDL [propget] HRESULT Maximized([out, retval] VARIANT_BOOL* pValue)
[propput] HRESULT Maximized([in] VARIANT_BOOL newValue)
.NET Boolean Maximized[get, set]
VB6 Maximized As Boolean

比較ウィンドウの最大化状態。

このプロパティは 取得と設定が可能です。

Minimized

IDL [propget] HRESULT Minimized([out, retval] VARIANT_BOOL* pValue)
[propput] HRESULT Minimized([in] VARIANT_BOOL newValue)
.NET Boolean Minimized[get, set]
VB6 Minimized As Boolean

比較ウィンドウの最小化状態。

このプロパティは 取得と設定が可能です。

Top

IDL [propget] HRESULT Top([out, retval] long* pValue)
[propput] HRESULT Top([in] long newValue)
.NET Int32 Top[get, set]
VB6 Top As Long

比較ウィンドウの上端のピクセル座標の位置。

このプロパティは 取得と設定が可能です。

Visible

IDL [propget] HRESULT Visible([out, retval] VARIANT_BOOL* pValue)
[propput] HRESULT Visible([in] VARIANT_BOOL newValue)
.NET Boolean Visible[get, set]
VB6 Visible As Boolean

比較ウィンドウの表示状態。

このプロパティは 取得と設定が可能です。

Width

IDL [propget] HRESULT Width([out, retval] long* pValue)
[propput] HRESULT Width([in] long newValue)
.NET Int32 Width[get, set]
VB6 Width As Long

比較ウィンドウの幅(ピクセル)。

このプロパティは 取得と設定が可能です。

プロパティ (IComparison インターフェイスによって実装されます )

ViewType

IDL [propget] HRESULT ViewType([out, retval] FileViewType* pValue)
[propput] HRESULT ViewType([in] FileViewType newValue)
.NET FileViewType ViewType[get, set]
VB6 ViewType As FileViewType

比較タイプ(2 者間または 3 者間レイアウト)。

このプロパティは 取得と設定が可能です。

プロパティ (IFileComparison インターフェイスによって実装されます )

AllUnresolvedConflicts

IDL [propget] HRESULT AllUnresolvedConflicts([out, retval] long* pValue)
.NET Int32 AllUnresolvedConflicts[get]
VB6 AllUnresolvedConflicts As Long

すべての比較ファイルの中にある未解決の不一致の数を提供します。

このプロパティは 取得のみです。

AutoSaveOnClose

IDL [propget] HRESULT AutoSaveOnClose([out, retval] VARIANT_BOOL* pValue)
[propput] HRESULT AutoSaveOnClose([in] VARIANT_BOOL newValue)
.NET Boolean AutoSaveOnClose[get, set]
VB6 AutoSaveOnClose As Boolean

Merge が閉じられるときに変更されたファイルが未保存の場合、通常、Merge はユーザーにこれらのファイルを保存するかどうかを尋ねます。これは、PromptForUnsavedFiles プロパティに false が設定されていない場合で、設定されている場合は未保存ファイルが破棄されます。ただし、AutoSaveOnClosetrue が設定されている場合、Merge はユーザーに尋ねることなく未保存ファイルを自動的に保存します。この機能は、Merge をほかのアプリケーションと統合する場合に便利です。

このプロパティは 取得と設定が可能です。

ComparisonError

IDL [propget] HRESULT ComparisonError([in, optional] VARIANT nFilePair, [out, retval] FileComparisonError* pValue)
.NET FileComparisonError get_ComparisonError(Object nFilePair)
VB6 ComparisonError( [nFilePair As Variant]) As FileComparisonError

Compare メソッドで発生するエラー。

このプロパティは 取得のみです。

引数

ComparisonResult

IDL [propget] HRESULT ComparisonResult([in, optional] VARIANT nFilePair, [out, retval] FileComparisonResult* pValue)
.NET FileComparisonResult get_ComparisonResult(Object nFilePair)
VB6 ComparisonResult( [nFilePair As Variant]) As FileComparisonResult

Compare メソッドで実行する比較の結果(fcrSame、fcrDifferent、fcrError)。

このプロパティは 取得のみです。

引数

ErrorInfo

IDL [propget] HRESULT ErrorInfo([in] short nFile, [out, retval] BSTR* pValue)
[propput] HRESULT ErrorInfo([in] short nFile, [in] BSTR newValue)
.NET String get_ErrorInfo(Int16 nFile)
void set_ErrorInfo(Int16 nFile, String newValue)
VB6 ErrorInfo(nFile As Integer) As String

ファイルの 1 つを読み込み/比較している間に発生したエラーに関する詳細情報を提供します。 nFile-1 の場合、3 つのファイルすべてに適用されるエラー(メモリ不足エラーなど)が返されます。

このプロパティは 取得と設定が可能です。

引数

Modified

IDL [propget] HRESULT Modified([in] short nFile, [out, retval] VARIANT_BOOL* pValue)
[propput] HRESULT Modified([in] short nFile, [in] VARIANT_BOOL newValue)
.NET Boolean get_Modified(Int16 nFile)
void set_Modified(Int16 nFile, Boolean newValue)
VB6 Modified(nFile As Integer) As Boolean

ファイルの修正状態を設定または取得可能にします。

このプロパティは 取得と設定が可能です。

引数

NumberOfChanges

IDL [propget] HRESULT NumberOfChanges([in, optional] VARIANT nFilePair, [out, retval] long* pValue)
.NET Int32 get_NumberOfChanges(Object nFilePair)
VB6 NumberOfChanges( [nFilePair As Variant]) As Long

2 つのファイル間の変更数。このプロパティと ChangeType、ChangeStartLine および ChangeLength プロパティを使用して比較ファイル間の変更を繰り返し処理します。注意 : 変更のセットには、削除/挿入/変更ブロック行のほかに未変更のブロック行も含まれます。

このプロパティは 取得のみです。

引数

PromptForUnsavedFiles

IDL [propget] HRESULT PromptForUnsavedFiles([out, retval] VARIANT_BOOL* pValue)
[propput] HRESULT PromptForUnsavedFiles([in] VARIANT_BOOL newValue)
.NET Boolean PromptForUnsavedFiles[get, set]
VB6 PromptForUnsavedFiles As Boolean

もし修正されたファイルを含んでいるファイル比較ウィンドウが閉じられる場合は、Merge は通常それらを保存する機会を提供します。このプロパティを false に設定すると、修正ファイルの保存 wウィンドウは表示されません。

AutoSaveOnClose プロパティも参照してください。

このプロパティは 取得と設定が可能です。

ReadOnly

IDL [propget] HRESULT ReadOnly([in] short nFile, [out, retval] VARIANT_BOOL* pValue)
[propput] HRESULT ReadOnly([in] short nFile, [in] VARIANT_BOOL newValue)
.NET Boolean get_ReadOnly(Int16 nFile)
void set_ReadOnly(Int16 nFile, Boolean newValue)
VB6 ReadOnly(nFile As Integer) As Boolean

ファイルの読み取り専用状態を設定または取得可能にします。

このプロパティは 取得と設定が可能です。

引数

SaveFileName

IDL [propget] HRESULT SaveFileName([out, retval] BSTR* pValue)
[propput] HRESULT SaveFileName([in] BSTR newValue)
.NET String SaveFileName[get, set]
VB6 SaveFileName As String

ファイル比較ウィンドウで変更を保存する(Ctrl+S キーまたは[上書き保存]コマンドを使用)ときに使うファイル名。

このプロパティは 取得と設定が可能です。

ThreeWayMergeActions

IDL [propget] HRESULT ThreeWayMergeActions([out, retval] IThreeWayMergeActions** pValue)
.NET ThreeWayMergeActions ThreeWayMergeActions[get]
VB6 ThreeWayMergeActions As ThreeWayMergeActions

1 番目と 3 番目のファイルの変更を中央の親ファイルへマージするために行われる必要があるアクションのコレクションを取得します。

このプロパティは 取得のみです。

UnresolvedConflicts

IDL [propget] HRESULT UnresolvedConflicts([in] short nFile, [out, retval] long* pValue)
.NET Int32 get_UnresolvedConflicts(Int16 nFile)
VB6 UnresolvedConflicts(nFile As Integer) As Long

比較ファイルの 1 つの中にある未解決の不一致の数を提供します。

このプロパティは 取得のみです。

引数

プロパティ (ITextComparison インターフェイスによって実装されます )

ChangeLength

IDL [propget] HRESULT ChangeLength([in] long nChange, [in] long nSide, [in, optional] VARIANT nFilePair, [out, retval] long* pValue)
.NET Int32 get_ChangeLength(Int32 nChange, Int32 nSide, Object nFilePair)
VB6 ChangeLength(nChange As Long, nSide As Long [, nFilePair As Variant]) As Long

変更の行数。

このプロパティは 取得のみです。

引数

ChangeStartLine

IDL [propget] HRESULT ChangeStartLine([in] long nChange, [in] long nSide, [in, optional] VARIANT nFilePair, [out, retval] long* pValue)
.NET Int32 get_ChangeStartLine(Int32 nChange, Int32 nSide, Object nFilePair)
VB6 ChangeStartLine(nChange As Long, nSide As Long [, nFilePair As Variant]) As Long

変更の開始行(0ベース)。

このプロパティは 取得のみです。

引数

ChangeType

IDL [propget] HRESULT ChangeType([in] long nChange, [in, optional] VARIANT nFilePair, [out, retval] ChangeStyle* pValue)
.NET ChangeStyle get_ChangeType(Int32 nChange, Object nFilePair)
VB6 ChangeType(nChange As Long [, nFilePair As Variant]) As ChangeStyle

変更のタイプ。変更は、挿入行、削除行、変更行、未変更行を表します。

このプロパティは 取得のみです。

引数

FileContent

IDL [propget] HRESULT FileContent([in] short nFile, [out, retval] BSTR* pValue)
[propput] HRESULT FileContent([in] short nFile, [in] BSTR newValue)
.NET String get_FileContent(Int16 nFile)
void set_FileContent(Int16 nFile, String newValue)
VB6 FileContent(nFile As Integer) As String

ファイルパネルの内容の設定、取得あるいは検索を可能にします。

このプロパティは 取得と設定が可能です。

引数

FullLineData

IDL [propget] HRESULT FullLineData([in] long nLine, [in] short nFile, [out, retval] BSTR* pValue)
.NET String get_FullLineData(Int32 nLine, Int16 nFile)
VB6 FullLineData(nLine As Long, nFile As Integer) As String

ファイルの 1 つにある行の内容。内容には、CR や LF の行終端文字が含まれます。

このプロパティは 取得のみです。

引数

FullLineLength

IDL [propget] HRESULT FullLineLength([in] long nLine, [in] short nFile, [out, retval] long* pValue)
.NET Int32 get_FullLineLength(Int32 nLine, Int16 nFile)
VB6 FullLineLength(nLine As Long, nFile As Integer) As Long

ファイルの 1 つにある行の長さ。長さには CR や LF の行終端文字が含まれます。

このプロパティは 取得のみです。

引数

LineData

IDL [propget] HRESULT LineData([in] long nLine, [in] short nFile, [out, retval] BSTR* pValue)
.NET String get_LineData(Int32 nLine, Int16 nFile)
VB6 LineData(nLine As Long, nFile As Integer) As String

ファイルの 1 つにある行の内容。内容には CR や LF の行終端文字は含まれません。

このプロパティは 取得のみです。

引数

LineLength

IDL [propget] HRESULT LineLength([in] long nLine, [in] short nFile, [out, retval] long* pValue)
.NET Int32 get_LineLength(Int32 nLine, Int16 nFile)
VB6 LineLength(nLine As Long, nFile As Integer) As Long

ファイルの 1 つにある行の長さ。長さには CR や LF の行終端文字は含まれません。

このプロパティは 取得のみです。

引数

NumberOfLines

IDL [propget] HRESULT NumberOfLines([in] short nFile, [out, retval] short* pValue)
.NET Int16 get_NumberOfLines(Int16 nFile)
VB6 NumberOfLines(nFile As Integer) As Integer

比較ファイルの行数。

このプロパティは 取得のみです。

引数

メソッド (ICommonUI インターフェイスによって実装されます )

Close

IDL HRESULT Close()
.NET void Close()
VB6 Close

比較ウィンドウを閉じます。

GiveUserControl

IDL HRESULT GiveUserControl()
.NET void GiveUserControl()
VB6 GiveUserControl

比較ウィンドウの起動から終了までをユーザーが制御できるようにします。未処理のオートメーション参照が解放されても、Merge は自動的に比較ウィンドウを閉じません。

Restore

IDL HRESULT Restore()
.NET void Restore()
VB6 Restore

比較ウィンドウを最小化または最大化された状態から通常のサイズ変更可能な状態に戻します。

メソッド (IComparison インターフェイスによって実装されます )

Compare

IDL HRESULT Compare([in] VARIANT strFirstFile, [in] VARIANT strSecondFile, [in, optional] VARIANT strThirdFile)
.NET void Compare(Object strFirstFile, Object strSecondFile, Object strThirdFile)
VB6 Compare(strFirstFile As Variant, strSecondFile As Variant [, strThirdFile As Variant])

2 つまたは 3 つのファイルを比較します。このメソッドは同期メソッドです。比較が完了して、エラーと結果を報告するときに、ComparisonComplete イベントが発生します。

引数

Print

IDL HRESULT Print([in] VARIANT_BOOL bShowPrinterDialog, [in] PageOrientation nOrientation)
.NET void Print(Boolean bShowPrinterDialog, PageOrientation nOrientation)
VB6 Print(bShowPrinterDialog As Boolean, nOrientation As PageOrientation)

ファイル比較を印刷します。

引数

Refresh

IDL HRESULT Refresh()
.NET void Refresh()
VB6 Refresh

ウィンドウに表示されているファイルを再度比較します。これにより、未保存の変更は破棄されます。

Report

IDL HRESULT Report([in] BSTR bstrReporter, [in] LineEndingStyle nLineEndingStyle, [in] BSTR strOutputFile)
.NET void Report(String bstrReporter, LineEndingStyle nLineEndingStyle, String strOutputFile)
VB6 Report(bstrReporter As String, nLineEndingStyle As LineEndingStyle, strOutputFile As String)

ファイル比較のレポートを生成します。

引数

Report2

IDL HRESULT Report2([in] BSTR bstrReporter, [in] LineEndingStyle nLineEndingStyle, [in] VARIANT vtEncoding, [in] BSTR strOutputFile)
.NET void Report2(String bstrReporter, LineEndingStyle nLineEndingStyle, Object vtEncoding, String strOutputFile)
VB6 Report2(bstrReporter As String, nLineEndingStyle As LineEndingStyle, vtEncoding As Variant, strOutputFile As String)

ファイル比較のレポートを生成します。

引数

SaveComparison

IDL HRESULT SaveComparison([in] BSTR filename)
.NET void SaveComparison(String filename)
VB6 SaveComparison(filename As String)

比較をファイルに保存します。ファイル名には .cmp7 拡張子を使用することをお勧めします。

引数

SetPanelTitles

IDL HRESULT SetPanelTitles([in] VARIANT strFirst, [in] VARIANT strSecond, [in, optional] VARIANT strThird)
.NET void SetPanelTitles(Object strFirst, Object strSecond, Object strThird)
VB6 SetPanelTitles(strFirst As Variant, strSecond As Variant [, strThird As Variant])

ファイル パネルの上に表示するタイトルを設定します。

引数

メソッド (IFileComparison インターフェイスによって実装されます )

CompareAsync

IDL HRESULT CompareAsync([in] VARIANT strFirstFile, [in] VARIANT strSecondFile, [in, optional] VARIANT strThirdFile)
.NET void CompareAsync(Object strFirstFile, Object strSecondFile, Object strThirdFile)
VB6 CompareAsync(strFirstFile As Variant, strSecondFile As Variant [, strThirdFile As Variant])

2 つまたは 3 つのファイルを比較します。このメソッドは非同期メソッドです(比較が完了する前に返されます)。比較が完了して、エラーと結果を報告するときに、ComparisonComplete イベントが発生します。

引数

SaveFile

IDL HRESULT SaveFile([in] short nFile, [in, optional] VARIANT strSaveTo)
.NET void SaveFile(Int16 nFile, Object strSaveTo)
VB6 SaveFile(nFile As Integer [, strSaveTo As Variant])

nFile パネルにファイルを保存します。strSaveTo 引数を使用すると、Merge では指定のファイルに[名前を付けて保存]を実行します。

引数

SaveFileAs

IDL HRESULT SaveFileAs([in] short nFile)
.NET void SaveFileAs(Int16 nFile)
VB6 SaveFileAs(nFile As Integer)

ファイルに新しい名前を付けて nFile パネルに保存する確認メッセージをユーザーに表示します。

引数

ThreeWayMerge

IDL HRESULT ThreeWayMerge([out, retval] long* pValue)
.NET Int32 ThreeWayMerge()
VB6 ThreeWayMerge As Long

3 者間比較で 2 つの(左右)外側のファイルを中央にある共通の親ファイルにマージします。マージが返される間に発生したマージの不一致の数。

メソッド (ITextComparison インターフェイスによって実装されます )

イベント (IFileComparisonEvents インターフェイスによって実装されます )

Close

IDL HRESULT Close()
.NET void Close()
VB6 Close

ファイル比較ウィンドウはユーザーが閉じます。

ComparisonComplete

IDL HRESULT ComparisonComplete([in] FileComparisonError error1, [in] FileComparisonResult result1, [in, optional] FileComparisonError error2, [in, optional] FileComparisonResult result2)
.NET void ComparisonComplete(FileComparisonError error1, FileComparisonResult result1, FileComparisonError error2, FileComparisonResult result2)
VB6 ComparisonComplete(error1 As FileComparisonError, result1 As FileComparisonResult [, error2 As FileComparisonError] [, result2 As FileComparisonResult])

ファイル比較が完了したときに発生します。2 つのファイルを比較する場合、最初の 2 つの引数のみが定義されます。3 つのファイルを比較する場合は、4 つすべての引数が定義されます。

引数


関連するトピック