### ITitle

  The ITitle class creates and updates the title bar area of your frame window. The ITitle class consists of the following three components:

  - Object text
  - View text
  - View number

  When you construct a title, you must provide the object text, while the other two are optional. The Open Class Library separates the object text and view text with a hyphen (-). The library separates the view text and view number with a colon (:). For example:

      OS/2 System - Icon View:2

  Use ITitle if you want the Common User Access (CUA) support for the object, view, and view number. If you do not, you can specify a title using an IFrameWindow constructor.

#### OS/2 Considerations

  While a title may exceed 60 bytes in length, only the first 60 bytes appear in a Window List entry. See the function IFrameWindow::addToWindowList for information on adding entries to the window list.

  Only one ITitle object is supported for each IFrameWindow object. The construction of the second ITitle object for the same IFrameWindow object will result in an IInvalidParameter exception.

#### Windows Considerations

  Because ITitle is not a separate window in the Windows operating system, the mechanism of autoDeleteObject (which deletes the object when the window is deleted) does not occur because there is no window being deleted. Therefore, do not use autoDeleteObject but instead perform your own delete's of the objects that your application creates using new.

### ITitle - Member Functions and Data by Group

### Constructors & Destructor

You can construct and destruct objects of the ITitle class. You cannot copy or assign ITitle objects because both the copy constructor and the assignment operator are private functions.

~ITitle

      public:
      virtual ~ITitle()

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

ITitle

  Overload 1

      public:
      ITitle( IWindow* owner,
              const IResourceId& objectName,
              const IResourceId& viewName = 0,
              unsigned long viewNumber = 0 )

  Use this function to construct ITitle objects from IResourceIds of STRINGTABLE items.

Exception

  .* This exception actually thrown in static function private to class.

  IInvalidRequest | The owner window of the ITitle object does not have a title bar. Make sure you have specified the correct owner window for the constructor.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

  Overload 2

      public:
      ITitle( IWindow* owner,
              const char* objectName = 0,
              const char* viewName = 0,
              unsigned long viewNumber = 0 )

  Use this function to construct ITitle objects from char*.

Exception

  .* This exception actually thrown in static function private to class.

  IInvalidRequest | The owner window of the ITitle object does not have a title bar. Make sure you have specified the correct owner window for the constructor.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### Attributes

Use these members to query the accessible attributes of objects of this class.

handle

      public:
      virtual IWindowHandle handle() const

  Returns the window handle.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

isValid

      public:
      virtual bool isValid() const

  If this object represents a valid window in the window system, true is returned. If the window has yet to be created or has already been destroyed, false is returned.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

owner

      public:
      virtual IWindow* owner() const

  Returns the window's owner. This function may return 0 if either of the following occurs:

  - The window was created without an owner
  - The owner window is not represented by an IWindow object
  Because a pointer value of 0 can cause unpredictable behavior, check the value of the returned pointer before using it.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### Colors

Use these members to query and set colors of the title area. You can query and set the active and inactive colors of the title area. You can query, set, and reset the active and inactive colors of the title's text foreground or background. You can query the border color of the title area.

activeColor

      public:
      virtual IColor activeColor() const

  Returns the active color value of the title area. If you have not set the color for the area, the default is returned.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

Windows Considerations

  Returns the default active color value of the title area.

activeTextBackgroundColor

      public:
      virtual IColor activeTextBackgroundColor() const

  Returns the active text background color value of the title area. If you have not set the color for the area, the default is returned.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

Windows Considerations

  Returns the default active text background color value of the title area.

activeTextForegroundColor

      public:
      virtual IColor activeTextForegroundColor() const

  Returns the active text foreground color value of the title area. If you have not set the color for the area, the default is returned.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

Windows Considerations

  Returns the default active text foreground color value of the title area.

inactiveColor

      public:
      virtual IColor inactiveColor() const

  Returns the inactive color value of the title area. If you have not set the color for the area, the default is returned.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

Windows Considerations

  Returns the default inactive color value of the title area.

inactiveTextBackgroundColor

      public:
      virtual IColor inactiveTextBackgroundColor() const

  Returns the inactive text background color value of the title area. If you have not set the color for the area, the default is returned.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

Windows Considerations

  Returns the default inactive text background color value of the title area.

inactiveTextForegroundColor

      public:
      virtual IColor inactiveTextForegroundColor() const

  Returns the inactive text foreground color value of the title area. If you have not set the color for the area, the default is returned.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

Windows Considerations

  Returns the default inactive text foreground color value of the title area.

resetActiveTextBackgroundColor

      public:
      virtual ITitle& resetActiveTextBackgroundColor()

  Resets the active text background color by undoing a previous set.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

resetActiveTextForegroundColor

      public:
      virtual ITitle& resetActiveTextForegroundColor()

  Resets the active text foreground color by undoing a previous set.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

resetInactiveTextBackgroundColor

      public:
      virtual ITitle& resetInactiveTextBackgroundColor()

  Resets the inactive text background color by undoing a previous set.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

resetInactiveTextForegroundColor

      public:
      virtual ITitle& resetInactiveTextForegroundColor()

  Resets the inactive text foreground color by undoing a previous set.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

setActiveTextBackgroundColor

      public:
      virtual ITitle&
        setActiveTextBackgroundColor( const IColor& color )

  Sets the active text background color to the specified color. The window area is identified by a system-defined presentation parameter value.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

setActiveTextForegroundColor

      public:
      virtual ITitle&
        setActiveTextForegroundColor( const IColor& color )

  Sets the active text foreground color to the specified color. The window area is identified by a system-defined presentation parameter value.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

setInactiveTextBackgroundColor

      public:
      virtual ITitle&
        setInactiveTextBackgroundColor( const IColor& color )

  Sets the inactive text background color to the specified color. The window area is identified by a system-defined presentation parameter value.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

setInactiveTextForegroundColor

      public:
      virtual ITitle&
        setInactiveTextForegroundColor( const IColor& color )

  Sets the inactive text foreground color to the specified color. The window area is identified by a system-defined presentation parameter value.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

### Notification Members

Use these members to identify and enable notifications sent to observer objects.

enableNotification

      public:
      virtual ITitle& enableNotification(bool enable = true)

  Enables the title to send notifications to any added observer objects.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

activeTextBackgroundColorId

      public:
      static INotificationId const
        activeTextBackgroundColorId

  Notification identifier provided to observers when the active text background color of the title changes.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Yes

activeTextForegroundColorId

      public:
      static INotificationId const
        activeTextForegroundColorId

  Notification identifier provided to observers when the active text foreground color of the title changes.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Yes

inactiveTextBackgroundColorId

      public:
      static INotificationId const
        inactiveTextBackgroundColorId

  Notification identifier provided to observers when the inactive text background color of the title changes.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Yes

inactiveTextForegroundColorId

      public:
      static INotificationId const
        inactiveTextForegroundColorId

  Notification identifier provided to observers when the inactive text foreground color of the title changes.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Yes

objectTextId

      public:
      static INotificationId const objectTextId

  Notification identifier provided to observers when the object text of the title changes. ITitle provides a pointer to the new text string in the INotificationEvent::eventData field of the INotificationEvent.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

viewNumberId

      public:
      static INotificationId const viewNumberId

  Notification identifier provided to observers when the view number of the title changes. ITitle provides the new view number in the INotificationEvent::eventData field of the INotificationEvent.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

viewTextId

      public:
      static INotificationId const viewTextId

  Notification identifier provided to observers when the view text of the title changes. ITitle provides a pointer to the new text string in the INotificationEvent::eventData field of the INotificationEvent.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### Text Processing

Use these members to manage the title's text. You can query and set the text as well as query the length of the text of the title.

#### AIX Considerations

  These functions were overloaded in Motif because of the Motif Window Manager. The title is a resource of the Motif Window Manager and not a separate control. Therefore there is not a valid handle for ITitle.

setText

  Sets the title text.

  Overload 1

      public:
      virtual ITitle& setText(const char* text)

  Use this function to set the title's text using a char*.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

  Overload 2

      public:
      virtual ITitle& setText(const IResourceId& textResId)

  Use this function to set the title's text using an IResourceId.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

text

      public:
      virtual IString text() const

  Returns the title text.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

textLength

      public:
      virtual unsigned long textLength() const

  Returns the current length of the title text, in bytes.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### Title Components

Use these members to query and set the title's components. You can set and query the text for the object or view. You can set and query the view number.

objectText

      public:
      virtual IString objectText() const

  Returns the object text.

Exception

  .* This exception actually thrown in static function private to class.

  IInvalidRequest | The owner window of the ITitle object does not have a title bar. Make sure you have specified the correct owner window for the constructor.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

setObjectText

  Sets the object text.
  Note: This function enforces the guideline that every window have a title. Therefore, you cannot use this function to put a null string in a frame window title. If you need to use a null string for a frame window title, call ITextControl::setText instead of this function.

  Overload 1

      public:
      virtual ITitle& setObjectText(const char* objectName)

  Use this function to set the object text using a char*.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

  Overload 2

      public:
      virtual ITitle&
        setObjectText( const IResourceId& objectNameResId )

  Use this function to set the object text from a string table ID from a specified resource library.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

setTitleText

  Sets all three components of a title (object text, view text, and view number) at once.

  Overload 1

      public:
      virtual ITitle&
        setTitleText( const char* objectName,
                      const char* viewName = 0,
                      unsigned long viewNum = 0 )

  Use this function to set the object name and view name using character strings.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

  Overload 2

      public:
      virtual ITitle&
        setTitleText( const IResourceId& objectNameResId,
                      const IResourceId& viewNameResId = 0,
                      unsigned long viewNum = 0 )

  Use this function to load the object and view text from a specified resource ID and resource library.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

setViewNumber

      public:
      virtual ITitle& setViewNumber(unsigned long viewNumber)

  Sets the view number.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

setViewText

  Sets the view text.

  Overload 1

      public:
      virtual ITitle& setViewText(const char* viewName)

  Use this function to set the view text using a char*.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

  Overload 2

      public:
      virtual ITitle&
        setViewText( const IResourceId& viewNameResId )

  Use this function to set the view text from a string table ID from a specified resource library.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

viewNumber

      public:
      virtual unsigned long viewNumber() const

  Returns the view number.

Exception

  .* This exception actually thrown in static function private to class.

  IInvalidRequest | The owner window of the ITitle object does not have a title bar. Make sure you have specified the correct owner window for the constructor.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

viewText

      public:
      virtual IString viewText() const

  Returns the view text.

Exception

  .* This exception actually thrown in static function private to class.

  IInvalidRequest | The owner window of the ITitle object does not have a title bar. Make sure you have specified the correct owner window for the constructor.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### Window Positioning

Use these members to query the size and position of windows. Unless otherwise noted, the orientation of the coordinates accepted and returned by these members is the application orientation. For more information about coordinate orientation, see ICoordinateSystem.

nativeRect

      public:
      virtual IRectangle nativeRect() const

  Returns a rectangle representing the position and size of the window. Unlike IWindow::rect, this function always returns the position in the native GUI orientation.
  Note: This function returns IRectangle(0,0,0,0) for a frame window if it is constructed using the shell position and the window has not been shown.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

parentSize

      public:
      virtual ISize parentSize() const

  Returns an ISize object representing the size of the client rectangle in the parent window. The client rectangle is the coordinate space used by child windows to specify their location. If the current window or parent is determined to be the desktop, the size of the desktop is returned.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | Yes

### ITitle - Inherited Member Functions and Data

#### Inherited Public Functions

  IControl

  -     virtual ~IControl()

  INotifier

  -     virtual ~INotifier()

  -     virtual INotifier& disableNotification() = 0

  -     virtual INotifier&
          enableNotification( bool enable = true ) = 0

  -     INotifier()

  -     virtual bool isEnabledForNotification() const = 0

  -     virtual INotifier&
          notifyObservers( const INotificationEvent& event ) = 0

  -     virtual INotifier&
          notifyObserversAsync( const INotificationEvent& event )

  -     const IThreadId& threadId() const

  ITextControl

  -     virtual ~ITextControl()

  -     static bool clipboardHasTextFormat()

  -     virtual ISize displaySize(const char* text = 0) const

  -     virtual ITextControl&
          setLayoutDistorted( unsigned long layoutAttributeOn,
                              unsigned long layoutAttributeOff )

  -     virtual ITextControl& setText(const char* text)

  -     virtual ITextControl& setText(const IResourceId& text)

  IWindow

  -     virtual ~IWindow()

  -     IAccelTblHandle acceleratorHandle() const

  -     IAcceleratorTable acceleratorTable() const

  -     IWindow&
          addOrReplaceAttribute( const IAttributeName& name,
                                 const IAttribute& attribute )

  -     IWindow&
          adoptWindowData( const DataHandle& typeToken,
                           IWindowData* windowData )

  -     virtual IString asDebugInfo() const

  -     virtual IString asString() const

  -     IAttributeName
          attributeNameAt( const AttributeCursor& cursor ) const

  -     const IAttribute*
          attributeWithName( const IAttributeName& name,
                             ESearchType search = kWindowOnly ) const

  -     virtual IColor backgroundColor() const

  -     virtual IWindow& capturePointer(bool capture = true)

  -     ISize characterSize() const

  -     IWindowHandle childAt(const ChildCursor& cursor) const

  -     IWindow* childWindowAt(const ChildCursor& cursor) const

  -     virtual IArgList
          convertToArgList( const IBitFlag& style ) const

  -     virtual unsigned long
          convertToGUIStyle( const IBitFlag& style,
                             bool extendedOnly = false ) const

  -     static DataHandle
          dataHandleWithKey( const char* dataKeyName )

  -     virtual IWindowHandle defaultEmphasisButton() const

  -     static SiblingOrder defaultOrdering()

  -     virtual IWindowHandle defaultPushButton() const

  -     static IWindow* desktopWindow()

  -     virtual IWindow& disable()

  -     virtual IColor disabledBackgroundColor() const

  -     virtual IColor disabledForegroundColor() const

  -     virtual IWindow& disableGroup()

  -     IWindow& disableMinimumSizeCaching()

  -     virtual IWindow& disableNotification()

  -     virtual IWindow& disableTabStop()

  -     virtual IWindow& disableUpdate()

  -     bool
          dispatchRemainingHandlers( IEvent& event,
                                     bool callDefProc = true )

  -     virtual IWindow& enable(bool enableWindow = true)

  -     virtual IWindow& enableGroup(bool enable = true)

  -     IWindow&
          enableMinimumSizeCaching( bool enableCaching = true )

  -     virtual IWindow& enableNotification(bool enable = true)

  -     virtual IWindow& enableTabStop(bool enable = true)

  -     virtual IWindow& enableUpdate(bool enableWindow = true)

  -     static IWindow::ExceptionFn* exceptionFunction()

  -     virtual IFont font() const

  -     virtual IColor foregroundColor() const

  -     virtual bool
          handleException( IException& dispatcherException,
                           IEvent& exceptionEvent )

  -     virtual IWindowHandle handleForChildCreation() const

  -     static IWindowHandle
          handleWithParent( unsigned long identifier,
                            const IWindowHandle& parent )

  -     static IWindowHandle handleWithPointerCaptured()

  -     virtual bool hasFocus() const

  -     virtual bool hasPointerCaptured() const

  -     unsigned long helpId() const

  -     virtual IWindow& hide()

  -     virtual IWindow& hideSourceEmphasis()

  -     virtual IColor hiliteBackgroundColor() const

  -     virtual IColor hiliteForegroundColor() const

  -     virtual unsigned long id() const

  -     virtual IRectangle invalidatedRect() const

  -     virtual IRegionHandle invalidatedRegion() const

  -     bool isAutoDeleteObject() const

  -     bool isAutoDestroyWindow() const

  -     bool isEnabled() const

  -     virtual bool isEnabledForNotification() const

  -     virtual bool isFrameWindow() const

  -     virtual bool isGroup() const

  -     bool isHandling(const EventMask& events) const

  -     virtual bool
          isLayoutDistorted( unsigned long layoutAttribute ) const

  -     bool isMinimumSizeCachingEnabled() const

  -     bool isShowing() const

  -     virtual bool isTabStop() const

  -     bool isUpdateEnabled() const

  -     bool isVisible() const

  -     static bool isWindowValid(const IWindow* window)

  -     IDMItemProvider* itemProvider() const

  -     IWindow(const IWindowHandle& handle)

  -     IWindow(unsigned long identifier, IWindow* parent)

  -     virtual IRectangle layoutAdjustment() const

  -     static IPoint
          mapPoint( const IPoint& point,
                    const IWindowHandle& from,
                    const IWindowHandle& to )

  -     virtual IWindowHandle
          matchForMnemonic( unsigned short character ) const

  -     IMessageQueueHandle messageQueue() const

  -     ISize minimumSize(bool windowCalculatedSize = false) const

  -     virtual IPointerHandle mousePointer() const

  -     static void movePointerTo(const IPoint& position)

  -     virtual IWindow&
          moveSizeTo( const IRectangle& newSizeAndPosition )

  -     virtual IWindow& moveTo(const IPoint& newPosition)

  -     virtual INotifierAddress notifierAddress() const

  -     virtual IWindow&
          notifyObservers( const INotificationEvent& event )

  -     virtual IWindow&
          notifyObserversAsync( const INotificationEvent& event )

  -     static IWindow* objectWindow()

  -     IWindow* parent() const

  -     static ISize parentSize(const IWindowHandle& windowHandle)

  -     static IPoint pointerPosition()

  -     virtual IPoint position() const

  -     virtual IWindow&
          positionBehindSibling( const IWindowHandle& siblingWindow )

  -     virtual IWindow& positionBehindSiblings()

  -     virtual IWindow& positionOnSiblings()

  -     virtual const IWindow& postEvent(const IEvent& event) const

  -     virtual const IWindow&
          postEvent( EventType eventType,
                     const IEventParameter1& parm1 = 0,
                     const IEventParameter2& parm2 = 0 ) const

  -     virtual const IWindow&
          postEvent( unsigned long eventId,
                     const IEventParameter1& parm1 = 0,
                     const IEventParameter2& parm2 = 0 ) const

  -     virtual IPresSpaceHandle presSpace() const

  -     virtual IRectangle rect() const

  -     virtual IWindow&
          refresh( const IRectangle& invalidRectangle,
                   bool immediate = false )

  -     virtual IWindow& refresh(RefreshType type = paintAll)

  -     virtual IWindow& releasePointer()

  -     virtual void
          releasePresSpace( const IPresSpaceHandle& presentationSpaceHandle ) const

  -     IWindow& removeAllAttributes()

  -     IWindow& removeAttribute(const IAttributeName& name)

  -     virtual IWindow& resetActiveColor()

  -     virtual IWindow& resetBackgroundColor()

  -     virtual IWindow& resetDisabledBackgroundColor()

  -     virtual IWindow& resetDisabledForegroundColor()

  -     virtual IWindow& resetFont()

  -     virtual IWindow& resetForegroundColor()

  -     virtual IWindow& resetHiliteBackgroundColor()

  -     virtual IWindow& resetHiliteForegroundColor()

  -     virtual IWindow& resetInactiveColor()

  -     IWindow& resetMinimumSize()

  -     virtual IWindow& resetShadowColor()

  -     virtual IEventResult sendEvent(const IEvent& event) const

  -     virtual IEventResult
          sendEvent( unsigned long eventId,
                     const IEventParameter1& parm1 = 0,
                     const IEventParameter2& parm2 = 0 ) const

  -     virtual IEventResult
          sendEvent( EventType eventType,
                     const IEventParameter1& parm1 = 0,
                     const IEventParameter2& parm2 = 0 ) const

  -     IWindow&
          setAcceleratorHandle( const IAccelTblHandle& handle )

  -     IWindow&
          setAcceleratorTable( const IAcceleratorTable* acceleratorTable )

  -     virtual IWindow& setActiveColor(const IColor& color)

  -     IWindow& setAutoDeleteObject(bool autoDelete = true)

  -     IWindow& setAutoDestroyWindow(bool autoDestroy = false)

  -     virtual IWindow& setBackgroundColor(const IColor& color)

  -     static void setDefaultOrdering(SiblingOrder order)

  -     virtual IWindow&
          setDisabledBackgroundColor( const IColor& color )

  -     virtual IWindow&
          setDisabledForegroundColor( const IColor& color )

  -     static IWindow::ExceptionFn*
          setExceptionFunction( IWindow::ExceptionFn* exceptionFunction )

  -     virtual IWindow& setFocus()

  -     virtual IWindow& setFont(const IFont& font)

  -     virtual IWindow& setForegroundColor(const IColor& color)

  -     IWindow& setHelpId(unsigned long helpTopicId)

  -     virtual IWindow&
          setHiliteBackgroundColor( const IColor& color )

  -     virtual IWindow&
          setHiliteForegroundColor( const IColor& color )

  -     virtual IWindow& setId(unsigned long newIdentifier)

  -     virtual IWindow& setInactiveColor(const IColor& color)

  -     IWindow& setItemProvider(IDMItemProvider* dragProvider)

  -     virtual IWindow&
          setLayoutDistorted( unsigned long layoutAttributesOn,
                              unsigned long layoutAttributesOff )

  -     IWindow& setMinimumSize(const ISize& size)

  -     virtual IWindow&
          setMousePointer( const IPointerHandle& mousePointer )

  -     virtual IWindow& setOwner(const IWindow* newOwner)

  -     virtual IWindow& setParent(const IWindow* newParent)

  -     virtual IWindow& setShadowColor(const IColor& color)

  -     virtual IColor shadowColor() const

  -     virtual IWindow& show(bool showWindow = true)

  -     virtual IWindow& showSourceEmphasis(bool show = true)

  -     virtual ISize size() const

  -     virtual IWindow& sizeTo(const ISize& newSize)

  -     IWindow& startHandling(const EventMask& events)

  -     IWindow& stopHandling(const EventMask& events)

  -     virtual IWindow&
          validateRect( const IRectangle& validatedRectangle )

  -     virtual IWindow&
          validateRegion( const IRegionHandle& validatedRegion )

  -     virtual IRectangle visibleRectangle() const

  -     IWindowData* windowData(const DataHandle& typeToken) const

  -     static IWindow*
          windowWithHandle( const IWindowHandle& windowHandle,
                            bool allThreads = true )

  -     static IWindow*
          windowWithOwner( unsigned long identifier,
                           const IWindow* owner,
                           bool allThreads = true )

  -     static IWindow*
          windowWithParent( unsigned long identifier,
                            const IWindow* parent,
                            bool allThreads = true )

#### Inherited Public Data

  IWindow

  -     static INotificationId const activeColorId

  -     static const EventMask allMouseMoves

  -     static INotificationId const
          attributeAddReplaceId

  -     static INotificationId const attributeRemoveId

  -     static INotificationId const backgroundColorId

  -     static INotificationId const borderColorId

  -     static const Style clipChildren

  -     static const Style clipSiblings

  -     static const Style clipToParent

  -     static INotificationId const commandId

  -     static const Style disabled

  -     static INotificationId const
          disabledBackgroundColorId

  -     static INotificationId const
          disabledForegroundColorId

  -     static INotificationId const enableId

  -     static INotificationId const focusId

  -     static INotificationId const fontId

  -     static INotificationId const foregroundColorId

  -     static const Style group

  -     static INotificationId const
          hiliteBackgroundColorId

  -     static INotificationId const
          hiliteForegroundColorId

  -     static INotificationId const inactiveColorId

  -     static const Style leftToRight

  -     static const EventMask mouseEntersLeaves

  -     static const Style noStyle

  -     static INotificationId const positionId

  -     static const Style rightToLeft

  -     static const Style saveBits

  -     static INotificationId const shadowColorId

  -     static INotificationId const sizeId

  -     static const EventMask someMouseMoves

  -     static const Style synchPaint

  -     static INotificationId const systemCommandId

  -     static const Style tabStop

  -     static const Style visible

  -     static INotificationId const visibleId

  INotifier

  -     static INotificationId const allChangesId

  -     static INotificationId const deleteId

  ITextControl

  -     static INotificationId const textId

#### Inherited Protected Functions

  IWindow

  -     IWindow& addHandler(IHandler* newHandler)

  -     virtual IWindow&
          addObserver( IObserver& observer,
                       const IInterest& interest )

  -     static void
          addToWindowSet( IWindow* window,
                          const IWindowHandle& windowHandle )

  -     IWindow& bindMessageQueue(bool bindToMessageQueue = true)

  -     virtual ISize calcMinimumSize() const

  -     IColor
          color( unsigned long colorArea,
                 const IColor& defaultColor ) const

  -     IColor color(unsigned long colorArea) const

  -     virtual IWindowHandle
          create( unsigned long id,
                  const char* text,
                  unsigned long style,
                  IXmCreateFunction createFunction,
                  const IWindowHandle& parent,
                  const IWindowHandle& owner,
                  const IRectangle& initRect,
                  const void* callerArgList,
                  unsigned int callerNumberArguments,
                  IWindow::SiblingOrder ordering = defaultOrdering ( ),
                  unsigned long extendedStyle = 0 )

  -     virtual IWindowHandle
          create( unsigned long id,
                  const char* text,
                  const IBitFlag& style,
                  IXmCreateFunction createFunction,
                  const IWindow* parent,
                  const IWindow* owner,
                  const IRectangle& initRect,
                  IWindow::SiblingOrder ordering = defaultOrdering ( ) )

  -     virtual IWindowHandle
          create( unsigned long id,
                  const char* text,
                  const IBitFlag& style,
                  const char* windowClass,
                  const IWindow* parent,
                  const IWindow* owner,
                  const IRectangle& initRect,
                  const void* ctlData,
                  const void* presParams,
                  IWindow::SiblingOrder ordering = defaultOrdering ( ) )

  -     virtual IWindowHandle
          create( unsigned long id,
                  const char* text,
                  unsigned long style,
                  const char* windowClass,
                  const IWindowHandle& parent,
                  const IWindowHandle& owner,
                  const IRectangle& initRect,
                  const void* ctlData,
                  const void* presParams,
                  IWindow::SiblingOrder ordering = defaultOrdering ( ),
                  unsigned long extendedStyle = 0 )

  -     IWindow& defaultProcedure(IEvent& event)

  -     bool deleteIsInProcess() const

  -     bool dispatch(IEvent& event)

  -     virtual unsigned long extendedStyle() const

  -     bool isBoundToMessageQueue() const

  -     virtual bool isDragStarting(IEvent& event)

  -     bool isPrimaryWindow() const

  -     bool isUserWindowWordReserved() const

  -     IWindow()

  -     IWindowNotifyHandler* notificationHandler() const

  -     virtual IWindow&
          notifyObservers( const INotificationId& notification )

  -     IObserverList&
          observerList( const IInterest* interest = 0 ) const

  -     virtual bool passEventToOwner(IEvent& event)

  -     virtual IWindow&
          prepareForUse( const IWindowHandle& windowHandle )

  -     virtual IWindow& removeAllObservers()

  -     static void removeFromWindowSet(IWindow* window)

  -     IWindow& removeHandler(IHandler* oldHandler)

  -     virtual IWindow& removeObserver(IObserver& observer)

  -     virtual IWindow&
          removeObserver( IObserver& observer,
                          const IInterest& interest )

  -     IWindow& reserveUserWindowWord(bool reserve = true)

  -     virtual IWindow& resetColor(unsigned long colorArea)

  -     ISize savedMinimumSize() const

  -     IWindow& saveMinimumSize(const ISize& size)

  -     virtual IWindow&
          setBidiSettings( const IBidiSettings& bidiSettings,
                           bool childInherit,
                           bool refresh )

  -     virtual IWindow&
          setColor( unsigned long colorArea,
                    const IColor& color )

  -     virtual IWindow&
          setDefaultEmphasisButton( const IWindowHandle& defaultEmphasisButton,
                                    bool enable )

  -     virtual IWindow&
          setDefaultPushButton( const IWindowHandle& defaultPushButton )

  -     virtual IWindow&
          setExtendedStyle( unsigned long extendedStyle )

  -     IWindow&
          setNotificationHandler( IWindowNotifyHandler* notifyHandler )

  -     virtual IWindow& setStyle(unsigned long style)

  -     IWindow& setWindowData(long index, unsigned long dataValue)

  -     IWindow&
          setWindowData( long index,
                         unsigned short dataValue )

  -     IWindow&
          startHandlingEventsFor( unsigned long identifier,
                                  IWindow* parent )

  -     IWindow&
          startHandlingEventsFor( const IWindowHandle& windowHandle )

  -     virtual unsigned long style() const

  -     IWindow& unbindMessageQueue()

  -     unsigned long windowULong(long index) const

  -     unsigned short windowUShort(long index) const

  INotifier

  -     virtual INotifier&
          addObserver( IObserver& observer,
                       const IInterest& interest )

  -     virtual INotifier&
          notifyObservers( const INotificationId& id ) = 0

  -     virtual IObserverList&
          observerList( const IInterest* anInterest = 0 ) const = 0

  -     virtual INotifier& removeAllObservers() = 0

  -     virtual INotifier&
          removeObserver( IObserver& observer,
                          const IInterest& interest )

  -     virtual INotifier& removeObserver(IObserver& observer) = 0

  IControl

  -     IControl()

  ITextControl

  -     ITextControl()

#### Inherited Protected Data

  - None