Preferences Object

This object provides access to Merge preferences. Preferences are divided up into multiple categories, based on the type of information stored. Each category is accessed through a separate property on this object.

Properties

Doublesread-onlyIPreferences

Preferences that are represented as double-precision floating-point values.

IDL [propget] HRESULT Doubles([out, retval] IDoublePreferences** pValue)
.NET DoublePreferences Doubles[get]

Filtersread-onlyIPreferences

Filters used to include/exclude files and folders in folder comparisons.

IDL [propget] HRESULT Filters([out, retval] IFilters** pValue)
.NET Filters Filters[get]

FilterFileTypesread-onlyIPreferences

Items that determine which types of comparison and optional filter programs are used to compare files with names matching specified patterns.

IDL [propget] HRESULT FilterFileTypes([out, retval] IFilterFileTypes** pValue)
.NET FilterFileTypes FilterFileTypes[get]

Longsread-onlyIPreferences

Preferences that are represented as long integer values.

IDL [propget] HRESULT Longs([out, retval] ILongPreferences** pValue)
.NET LongPreferences Longs[get]

RegularExpressionsread-onlyIPreferences

Regular expressions used to ignore unimportant text in text comparisons.

IDL [propget] HRESULT RegularExpressions([out, retval] IRegularExpressions** pValue)
.NET RegularExpressions RegularExpressions[get]

Stringsread-onlyIPreferences

Preferences that are represented as string values.

IDL [propget] HRESULT Strings([out, retval] IStringPreferences** pValue)
.NET StringPreferences Strings[get]

Methods

LoadFromFileIPreferences

Loads Merge options from a previously saved .mop7 file.

IDL HRESULT LoadFromFile(
    [in] BSTR filename)
.NET void LoadFromFile(
    String filename)
  • filename
    The name of the file from which Merge options should be loaded.

SaveIPreferences

Saves preferences to the Registry, and propagates them to other running instances of Merge. Without this method, preferences are only saved to the Registry when Merge exits.

IDL HRESULT Save()
.NET void Save()

SaveToFileIPreferences

Saves Merge options to a file. We recommend that you use the .mop7 extension in the filename.

IDL HRESULT SaveToFile(
    [in] BSTR filename)
.NET void SaveToFile(
    String filename)
  • filename
    The name of the file to which Merge options should be saved.

ShowOptionsWindowIPreferences

Displays the Merge Options dialog. The method returns when the user closes the window.

IDL HRESULT ShowOptionsWindow(
    [in] VARIANT vWndParent)
.NET void ShowOptionsWindow(
    Object vWndParent)
  • vWndParent
    An optional argument that can be used to specify a parent window for the Options dialog.