DialogPage::Window Property

 

Gets the window that is used as the user interface of the dialog page.

Namespace:   Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.14.0 (in Microsoft.VisualStudio.Shell.14.0.dll)

protected:
[BrowsableAttribute(false)]
[DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility::Hidden)]
property IWin32Window^ Window {
	virtual IWin32Window^ get();
}

Property Value

Type: System.Windows.Forms::IWin32Window^

An IWin32Window that provides the handle to the window that acts as the user interface for the dialog page.

By default this property returns a property grid that has an entry for each public property that supports conversion to and from strings through TypeConverter.

Visual Studio requires that Tools Options page windows must be constant and should not be re-created on successive calls. Some user interface controls, particularly Windows Forms controls, can create and destroy their window handles at will, and this must be avoided. One way of doing this is to return Windows Forms that are derived from UserControl.

If the window implements T:System.ComponentModelIComponent, it is sited by the dialog page so that it can get access to global services.

System_CAPS_noteNote

Typically, an instance of a dialog page class is its own automation object. Therefore, properties that are displayed are those of a class that is derived from DialogPage. However, if AutomationObject returns another object, it is that object's properties, and not the properties of the class, that are displayed.

Return to top
Show: