ArcObjects Library Reference (CatalogUI)

IGxDialog Interface

Provides access to members that control the GxDialog.

Product Availability

Available with ArcGIS Desktop.

Description

The IGxDialog interface is implemented by the GxDialog object and provides access to the properties of the dialog box object and methods for displaying the dialog box during open or save operations. Use this interface when you want to access the properties of the dialog box or when you wish to display the dialog box for input from the end user.

What the user can select or specify when using a GxDialog browser is based on the filters (GxObjectFilter) held by the object. The GxDialog object implements the IGxObjectFilterCollection interface. It provides access to the set of filters used by the GxDialog object. Even though a collection of filters can be attached to a GxDialog object, onlyone filter is actually active at a time. The active filter is specified through the dialog box when DoModalOpen or DoModalSave is executed through the IGxDialog interface. Use the IGxObjectFilterCollection interface when you want to remove all of the filters or when you want to add an additional filter to the object.

When To Use

Use the IGxDialog interface when you want to invoke a dialog to pick one or more GIS datasets or to save GIS data to disk.

Members

		Description
	AllowMultiSelect	Indicates if multiple items may be selected. False, by default.
	ButtonCaption	The caption to use for the Open or Save button.
	DoModalOpen	Opens the dialog to choose data.
	DoModalSave	Opens the dialog to save data.
	FinalLocation	The dialog's final location.
	InternalCatalog	The catalog object used internally by the GxDialog.
	Name	The text in the Name text box (only for DoModalSave).
	ObjectFilter	The object filter.
	RememberLocation	Indicates if the dialog should use the final location as the next starting location. True, by default.
	ReplacingObject	Indicates if an object already exists with the name supplied by the user, and is being replaced.
	StartingLocation	The dialog's starting location. This can be an IGxObject or a text-string containing the full name of an object.
	Title	The dialog's title.

CoClasses that implement IGxDialog

CoClasses and Classes	Description
GxDialog	Provides access to GX browser dialog.

Remarks

If you are writing an application in Visual C++ that creates/uses a GxDialog object, the application needs to call ::OleInitialize() instead of ::CoInitialize() prior to creating the GxDialog.

.NET Samples

Create an NDVI custom raster function (Code Files: NDVICustomFunctionUIForm) | Create a custom raster function (Code Files: WatermarkFunctionUIForm) | Browse for Python files (Code Files: CustomCommand) | Tabbed feature inspector (Code Files: AddEXTCLSID)

.NET Related Topics

CatalogUI