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]
VB6 Doubles As DoublePreferences

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]
VB6 Filters As Filters

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]
VB6 FilterFileTypes As FilterFileTypes

Longsread-onlyIPreferences

Preferences that are represented as long integer values.

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

RegularExpressionsread-onlyIPreferences

Regular expressions used to ignore unimportant text in text comparisons.

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

Stringsread-onlyIPreferences

Preferences that are represented as string values.

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

Methods

LoadFromFileIPreferences

Loads Merge options from a previously saved .mop7 file.

IDL HRESULT LoadFromFile(
    [in] BSTR filename)
.NET void LoadFromFile(
    String filename)
VB6 LoadFromFile(
    filename As String)
  • 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()
VB6 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)
VB6 SaveToFile(
    filename As String)
  • 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)
VB6 ShowOptionsWindow(
    vWndParent As Variant)
  • vWndParent
    An optional argument that can be used to specify a parent window for the Options dialog.