Preferences Object

On this page:

• Description
• Properties
  • Doubles read-only, IPreferences
  • Filters read-only, IPreferences
  • FilterFileTypes read-only, IPreferences
  • Longs read-only, IPreferences
  • RegularExpressions read-only, IPreferences
  • Strings read-only, IPreferences
• Methods
  • LoadFromFile IPreferences
  • Save IPreferences
  • SaveToFile IPreferences
  • ShowOptionsWindow IPreferences

Description

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

Doubles read-only, IPreferences

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

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

Filters read-only, IPreferences

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

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

FilterFileTypes read-only, IPreferences

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]

Longs read-only, IPreferences

Preferences that are represented as long integer values.

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

RegularExpressions read-only, IPreferences

Regular expressions used to ignore unimportant text in text comparisons.

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

Strings read-only, IPreferences

Preferences that are represented as string values.

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

Methods

LoadFromFile IPreferences

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.

Save IPreferences

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()

SaveToFile IPreferences

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.

ShowOptionsWindow IPreferences

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.