ArcObjects Library Reference (Framework)

DockableWindow Class

DockableWindow object.

DockableWindow is a non-creatable object. References to non-creatable objects must be obtained through other objects.

Product Availability

Available with ArcGIS Desktop.

Description

A DockableWindow is an auxillary window that can display data. This window is treated as a modeless child window of that application. It can exist in a floating state or attached to the main application window.

The Table of Contents in ArcMap is a dockable window.

Use the IDockableWindowManager interface to get access to a particular dockable window. You can implement the IDockableWindowDef interface to create a custom dockable window.

Supported Platforms

Windows

Extended Error Information

Use the ISupportErrorInfo method InterfaceSupportsErrorInfo to determine if the object supports extended error information. If the object supports extended error info, VC++ developers should use the OLE/COM IErrorInfo interface to access the ErrorInfo object. Visual Basic developers should use the global error object Err to retrieve this extended error information.

Interfaces

Interfaces	Description
IDockableWindow	Provides access to members that define and control a dockable window.
ISupportErrorInfo	Indicates whether a specific interface can return Automation error objects.
IWindowPosition	Provides access to members that query or modify a window's position, size and state.

Remarks

The DockableWindow class also implements the IWindowPosition interface. You can use this interface to size and position your dockable window. Note, the dockable window must be in a floating state before you call any of the properties or methods on IWindowPosition.

[C#]

The following code shows how you can use the Move method on IWindowPosition to size and position the TOC.

public void MoveTOC(IApplication app)
{ 
  IDockableWindowManager docWinMgr=app as IDockableWindowManager; 'cast
  UID tocID=new UIDClass();
  tocID.Value="{368131A0-F15F-11D3-A67E-0008C7DF97B9}";
  IDockableWindow theTOC=docWinMgr.GetDockableWindow(tocID);
  IWindowPosition winPos=theTOC as IWindowPosition;  'cast

  if (theTOC.IsVisible())
  {  
    theTOC.Dock(esriDockFlags.esriDockFloat);
    winPos.Move(10, 10, 150, 300);
  }
}

[Visual Basic .NET]

The following code shows how you can use the Move method on IWindowPosition to size and position the TOC.

Public Sub MoveTOC(app As IApplication)
  Dim docWinMgr As IDockableWindowManager
  Dim theTOC As IDockableWindow
  Dim winPos As IWindowPosition
  
  docWinMgr=CType(app, IDockableWindowManager) 'cast
  Dim tocID As UID=New UIDClass 
  tocID.Value="{368131A0-F15F-11D3-A67E-0008C7DF97B9}" 
  theTOC=docWinMgr.GetDockableWindow(tocID)
  winPos=CType(theTOC, IWindowPosition)  'cast

  If theTOC.IsVisible() Then
    theTOC.Dock(esriDockFlags.esriDockFloat)
    winPos.Move(10, 10, 150, 300)
  End If
End Sub