In This Article

DocumentWindow Class

Represents a document window.

public class DocumentWindow : TabbedMdiWindow, IUIControl, IUIElement, ILogicalTreeNode, IDpiAwareElement, IDisposable, IDockObject, IImageListProvider
Inheritance:
object MarshalByRefObject Component Control ScrollableControl ContainerControl UIContainerControl TabbedMdiWindow object
Implements:
IUIControl IUIElement ILogicalTreeNode IDpiAwareElement IDisposable IDockObject IImageListProvider

Constructors

DocumentWindow()

Initializes an instance of the class.

public DocumentWindow()

Remarks

For internal use only. Please use the other constructors.

DocumentWindow(DockManager, string, string, Image?, Control?)

Initializes an instance of the class.

public DocumentWindow(DockManager dockManager, string key, string text, Image? image, Control? childControl = null)
Parameter Type Description
dockManager DockManager

The DockManager that is managing the dock object.

key string

A string-based key that identifies an object within its parent collection.

text string

The text that is displayed in tabs for the document window.

image Image

The Image displayed for the document window.

childControl Control

The child Control to fill the document window. This value may be null.

DocumentWindow(DockManager, string, string, int, Control?)

Initializes an instance of the class.

public DocumentWindow(DockManager dockManager, string key, string text, int imageIndex = -1, Control? childControl = null)
Parameter Type Description
dockManager DockManager

The DockManager that is managing the dock object.

key string

A string-based key that identifies an object within its parent collection.

text string

The text that is displayed in tabs for the document window.

imageIndex int

The index of an Image within an ImageList, that is displayed for the document window.

childControl Control

The child Control to fill the document window. This value may be null.

Properties

CanFloat

Indicates whether the document window may be contained in a floating window.

public DefaultableBoolean CanFloat { get; set; }

Property Value

DefaultableBoolean

Remarks

If set to Default, the resolved value will use the global DockManager setting.

DefaultFloatingLocation

The default value for FloatingLocation.

public static Point DefaultFloatingLocation { get; set; }

Property Value

Point

DefaultFloatingSize

The default value for FloatingSize.

public static Size DefaultFloatingSize { get; set; }

Property Value

Size

DockManager

The DockManager that is managing the dock object.

[Browsable(false)]
public override DockManager? DockManager { get; set; }

Property Value

DockManager

DockObjectType

A DockObjectType specifying the type of dock object.

[Browsable(false)]
public override DockObjectType DockObjectType { get; }

Property Value

DockObjectType

FileName

The file name represented by this document window.

public string? FileName { get; set; }

Property Value

string

Remarks

This property's value is displayed on the Next Window Navigation Form.

FileType

The file type represented by this document window.

public string? FileType { get; set; }

Property Value

string

Remarks

This property's value is displayed on the Next Window Navigation Form.

FloatingLocation

The location of the document window when it is in a floating state.

public Point FloatingLocation { get; set; }

Property Value

Point

Remarks

Setting this property at run-time will move the document window if it is floating.

FloatingSize

The size of the document window when it is in a floating state.

public Size FloatingSize { get; set; }

Property Value

Size

Remarks

Setting this property at run-time will resize the document window if it is floating.

Modified

Indicates whether the document window's data has been modified.

public bool Modified { get; set; }

Property Value

bool:

true if the document window's data has been modified; otherwise, false.

Remarks

If this property is set to true then an asterisk (*) character will appear next to its name in tabs.

State

The DocumentWindowState of the document window.

[Browsable(false)]
public DocumentWindowState State { get; set; }

Property Value

DocumentWindowState

TabbedMdiContainer

The TabbedMdiContainer that contains the dock object.

[Browsable(false)]
public override TabbedMdiContainer? TabbedMdiContainer { get; }

Property Value

TabbedMdiContainer

Methods

Activate(bool)

Activates the window, ensures that it is visible, and optionally sets focus.

public override void Activate(bool focus)
Parameter Type Description
focus bool

Whether to set focus to the window.

Close(TabbedMdiWindowCloseReason)

Closes the window.

public override void Close(TabbedMdiWindowCloseReason reason)
Parameter Type Description
reason TabbedMdiWindowCloseReason

A TabbedMdiWindowCloseReason that specifies why the window was closed.

Dispose(bool)

Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources.

protected override void Dispose(bool disposing)
Parameter Type Description
disposing bool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

IsMenuItemChecked(TabbedMdiWindowContextMenuItemType)

Returns whether the specified type of menu item should be checked for the window.

public override bool IsMenuItemChecked(TabbedMdiWindowContextMenuItemType menuItemType)
Parameter Type Description
menuItemType TabbedMdiWindowContextMenuItemType

A TabbedMdiWindowContextMenuItemType specifying the type of menu item to examine.

Returns

bool:

true if the menu item type should be checked; otherwise, false.

IsMenuItemEnabled(TabbedMdiWindowContextMenuItemType)

Returns whether the specified type of menu item should be enabled for the window.

public override bool IsMenuItemEnabled(TabbedMdiWindowContextMenuItemType menuItemType)
Parameter Type Description
menuItemType TabbedMdiWindowContextMenuItemType

A TabbedMdiWindowContextMenuItemType specifying the type of menu item to examine.

Returns

bool:

true if the menu item type should be enabled; otherwise, false.

IsMenuItemVisible(TabbedMdiWindowContextMenuItemType)

Returns whether the specified type of menu item should be visible for the window.

public override bool IsMenuItemVisible(TabbedMdiWindowContextMenuItemType menuItemType)
Parameter Type Description
menuItemType TabbedMdiWindowContextMenuItemType

A TabbedMdiWindowContextMenuItemType specifying the type of menu item to examine.

Returns

bool:

true if the menu item type should be visible; otherwise, false.

ResetFloatingLocation()

Resets the FloatingLocation property to its default value.

public virtual void ResetFloatingLocation()

ResetFloatingSize()

Resets the FloatingSize property to its default value.

public virtual void ResetFloatingSize()

ShouldSerializeFloatingLocation()

Indicates whether the FloatingLocation property should be persisted.

public virtual bool ShouldSerializeFloatingLocation()

Returns

bool:

true if the property value has changed from its default; otherwise, false.

ShouldSerializeFloatingSize()

Indicates whether the FloatingSize property should be persisted.

public virtual bool ShouldSerializeFloatingSize()

Returns

bool:

true if the property value has changed from its default; otherwise, false.

Undock()

Undocks the DocumentWindow.

public void Undock()

UpdateUI()

Updates the user interface that is related to the window.

protected override void UpdateUI()

Inherited Members

Extension Methods