### IStaticText

  The IStaticText class creates and manages static text control windows. Static text controls are simple text fields that do not accept user input. For example,

        IStaticText sttxtText(ID_TEXT, this, this, IRectangle(10,10,70,24)));
        sttxtText.setText("It is a wonderful day");

  You can use the classes derived from IStaticText to display bitmaps and icons.

  You can use IStaticText to create text prompts and labels. You can give the static text a background color so that it has the appearance of a box. By using a background color and no text, you can create a solid box with nothing inside it.

  You can attach the following handlers to this control:

  - IMouseHandler
  - IPaintHandler
  - IResizeHandler

#### Portability Considerations

  OS/2 applications can use the IStaticText control to create boxes that label, box, or frame other controls.

  The IStaticText control can be parent, child, or owner of these other controls. However, for portable applications, you should use IFrameWindow, IOutlineBox, or the canvas classes instead of IStaticText.

#### OS/2 Considerations

  If you do not set a fill color, the background color is used as the fill color.

### IStaticText - Member Functions and Data by Group

### Constructors & Destructor

You can construct and destruct objects of the IStaticText class. You cannot copy or assign IStaticText objects because both the copy and assignment operator are private functions. You can construct objects of this class in the following ways:

- Create the specified static text control and an object for it
- Create the object for the specified static text control

~IStaticText

      public:
      virtual ~IStaticText()

Supported Platforms

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

IStaticText

  Overload 1

      public:
      IStaticText(unsigned long id, IWindow* parent)

  Creates an object for a static text control that exists in a dialog window.

  id
    The ID of the existing static text control.
  parent
    The parent window.

Supported Platforms

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

  Overload 2

      public:
      IStaticText(const IWindowHandle& handle)

  Creates an object for an existing static text control.

  handle
    The window handle of an existing static text control.

Supported Platforms

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

  Overload 3

      public:
      IStaticText( unsigned long id,
                   IWindow* parent,
                   IWindow* owner,
                   const IRectangle& initial = IRectangle ( ),
                   const Style& style = defaultStyle ( ) )

  Creates a static text control and an object for it.

  id
    A static text control ID.
  parent
    The parent window.
  owner
    The owner window.
  initial
    The initial position and size of the control you are constructing. Optional.
  style
    The control's characteristics. Optional.

Exception

  IInvalidParameter | The parent window pointer specified was invalid. You must specify a valid IWindow pointer as the parent.

Supported Platforms

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

### Alignment

Use these members to query and set the alignment of the static text control.

alignment

      public:
      Alignment alignment() const

  Returns the current alignment for this static text object. The returned value is an Alignment enumerator.

Supported Platforms

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

setAlignment

      public:
      virtual IStaticText&
        setAlignment( Alignment alignment = IStaticText::topLeft )

  Sets the alignment of the static text.

Exception

  IInvalidParameter | The alignment value specified is invalid. See the documentation for the Alignment group under IStaticText for valid alignment values.

Supported Platforms

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

### Bidirectional Language Support

These members allow a window to support bidirectional languages, such as Arabic and Hebrew. These languages are written and read right-to-left, but text in these languages may also contain strings that are written and read left-to-right.

setBidiSettings

      protected:
      virtual IStaticText&
        setBidiSettings( const IBidiSettings& bidiSettings,
                         bool childInherit,
                         bool refresh )

  This function allows a static text control object to provide special processing to support a change in its bidirectional characteristics. This function is called just before the bidirectional characteristics of the static text object change. This function is not called when you create a static text object.

  bidiSettings
    The new bidirectional settings for the static text object.
  childInherit
    This flag specifies if the child windows of the static text control will inherit the new bidirectional attributes.
  refresh
    This flag specifies if the static text control will paint after receiving the new directional attributes.

Supported Platforms

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

AIX Considerations

  This function is not provided because you cannot change the bidirectional attributes of a window on that platform after you create it.

OS/2 Considerations

  IStaticText does not override IWindow::setBidiSettings on this platform.

Windows Considerations

  If the window layout direction is changing, the static text object may call setAlignment to change how it aligns its text.

### Colors

Use these members to query, set, and reset colors for the static text control. You can query the foreground and background colors. You can query and set the fill color for the static text.

backgroundColor

      public:
      virtual IColor backgroundColor() const

  Returns the background color of the static text object. If you do not set a color for this area, the default is returned.

Supported Platforms

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

Portability Considerations

  This member is overridden in this derived class for specific operating system behavior.

AIX Considerations

  In AIX, the backgroundColor functions inherited from IWindow is used.

OS/2 Considerations

  The default is from the owner window chain or color scheme on the OS/2 platform.

fillColor

      public:
      virtual IColor fillColor() const

  Returns the fill color value of the static text. If you do not set the fill color, the default is returned.

Supported Platforms

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

AIX Considerations

  Fill color and background color are identical in the AIX environment. Therefore, this function returns the background color in this environment.

foregroundColor

      public:
      virtual IColor foregroundColor() const

  Returns the foreground color value of the static text. If you do not set the color for the area, the default is returned.

Supported Platforms

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

Portability Considerations

  This member is overridden in this derived class for specific operating system behavior.

resetFillColor

      public:
      virtual IStaticText& resetFillColor()

  Resets the fill color by undoing a previous set.

Supported Platforms

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

AIX Considerations

  This function is the same as resetBackgroundColor in the AIX environment.

setFillColor

      public:
      virtual IStaticText& setFillColor(const IColor& color)

  Sets the color for the area of the static text control window that does not have text.

Supported Platforms

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

AIX Considerations

  This function is equivalent to setBackgroundColor in the AIX environment.

### Event-Handling Implementation

Event-handling implementation members perform processing needed to allow handlers to properly receive GUI events and to route these events.

passEventToOwner

      protected:
      virtual bool passEventToOwner(IEvent& event)

  Determines if the event is passed on to the owner.

Supported Platforms

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

### Fill Background

Use these members to query and set the fill background of the static text control. If fill background is enabled, the background of the static text control is erased before the text is drawn.

disableFillBackground

      public:
      virtual IStaticText& disableFillBackground()

  Draws text over the current background.

Supported Platforms

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

AIX Considerations

  The fillBackground style is always enabled in AIX; therefore, this function has no effect.

enableFillBackground

      public:
      virtual IStaticText&
        enableFillBackground( bool enable = true )

  Erases the background before the text is drawn.
  Note: If you call this function on an object of a derived class, such as IBitmapControl or IIconControl, the graphic is overlaid by the background color.

Supported Platforms

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

AIX Considerations

  The fillBackground style is ignored in AIX; therefore, this function has no effect.

hasFillBackground

      public:
      bool hasFillBackground() const

  If the background is erased before any text is drawn, true is returned. Otherwise, false is returned.

Supported Platforms

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

AIX Considerations

  The fillBackground style is ignored in AIX. This function returns false.

### Layout Support

Layout support members are overrides that supply information used by the canvas classes to provide dialog-like behavior.

addDrawingHandler

      protected:
      IStaticText& addDrawingHandler()

  Adds the drawing handler to the static text object. This will occur automatically if style settings warrant.

Supported Platforms

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

calcLimitSize

      protected:
      virtual ISize calcLimitSize() const

  Returns a size based on the text limit value, the current font, and whether or not the wordBreak style is set.

Supported Platforms

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

calcMinimumSize

      protected:
      virtual ISize calcMinimumSize() const

  Returns the recommended minimum size for this static text control. The size is based on the following:

  - The text string length
  - The current font
  - The wordBreak style
  - The value returned by IStaticText::calcLimitSize

Supported Platforms

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

### Minimum Size Adjustment

Use these members to set and query the number of characters that the minimum size can be based on.

limit

      public:
      unsigned long limit() const

  Returns the number of characters set by setLimit. You can use this limit or calcMinimumSize to determine a minimum limit for the static text control.

Supported Platforms

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

setLimit

      public:
      virtual IStaticText& setLimit(unsigned long limit = 0)

  Sets the minimum number of characters in a maximum size static text control.

  Use this for static text controls that change the text displayed on an ISetCanvas or IMultiCellCanvas to avoid causing the canvas to update the layout of its child windows with each change to the static text contents.

  calcLimitSize uses a nonzero limit value to calculate a minimum size for this window. The size can be larger than the actual size needed to hold the currently displayed text.

  The minimum size used is the larger of either of the following:

  - The calculated minimum size
  - The size that accommodates the displayed text based on the current font and whether or not the wordBreak style is set.

  If this function is not called, the minimum size needed to display the current text is the default.

Supported Platforms

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

### Notification Members

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

fillBackgroundId

      public:
      static INotificationId const fillBackgroundId

  Notification identifier provided to observers when the fill background style of a static text control changes. IStaticText provides a boolean value in the INotificationEvent::eventData field of the INotificationEvent. This value is true if fillBackground is now enabled, and false if fillBackground is disabled.

Supported Platforms

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

fillColorId

      public:
      static INotificationId const fillColorId

  Notification identifier provided to observers when the fill color of a static text control changes.

Supported Platforms

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

halftoneId

      public:
      static INotificationId const halftoneId

  Notification identifier provided to observers when the halftone style of a static text control changes. IStaticText provides a boolean value in the INotificationEvent::eventData field of the INotificationEvent. This value is true if halftone is now enabled, and false if halftone is disabled.

Supported Platforms

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

limitId

      public:
      static INotificationId const limitId

  Notification identifier provided to observers when the text limit of a static text control changes. IStaticText provides the new limit value in the INotificationEvent::eventData field of the INotificationEvent.

Supported Platforms

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

strikeoutId

      public:
      static INotificationId const strikeoutId

  Notification identifier provided to observers when the strikeout style of a static text control changes. IStaticText provides a boolean value in the INotificationEvent::eventData field of the INotificationEvent. This value is true if strikeout is now enabled, and false if strikeout is disabled.

Supported Platforms

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

underscoreId

      public:
      static INotificationId const underscoreId

  Notification identifier provided to observers when the underscore style of a static text control changes. IStaticText provides a boolean value in the INotificationEvent::eventData field of the INotificationEvent. This value will be true if underscore is now enabled, and false if underscore is disabled.

Supported Platforms

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

### Styles

These style members provide a set of valid styles for the IStaticText class. You can use these styles with the styles in IWindow.

#### AIX Considerations

  AIX does not support the following styles:

  - fillBackground
  - halftone
  - mnemonic
  - strikeout
  - underscore

convertToGUIStyle

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

  Converts a style object into a value appropriate for the presentation system. The default action is to return the base GUI styles for the platform. Extended styles, those defined by the application and the Open Class Library, are returned if you set extendedOnly to true.

Supported Platforms

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

defaultStyle

      public:
      static Style defaultStyle()

  Returns the default style. The default style is classDefaultStyle unless you have changed it using setDefaultStyle.

Supported Platforms

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

setDefaultStyle

      public:
      static void setDefaultStyle(const Style& style)

  Sets the default style for all subsequent static text controls.

  style
    Use the styles provided by IStaticText Styles to specify the default style.

  This member function is not thread safe. In a multithreaded application, it should only be called when a conflict is not possible. A conflict can arise if you set the default style on one thread at the same time that it is being queried on another. In this situation, the query would take place while the style is in an unknown state.

  When you create a window class and do not specifically specify window styles in the constructor, the Open Class Library queries the default style. Therefore, the only safe place to call this member function is when no other application threads that create windows are active.

  Another way to avoid a conflict in a multithreaded application is to specifically specify window styles on window construction, rather than calling this member function.

Supported Platforms

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

border3D

      public:
      static const Style border3D

  Adds an etched 3D border to the control.

Supported Platforms

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

bottom

      public:
      static const Style bottom

  Aligns the text at the bottom of the window

Supported Platforms

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

center

      public:
      static const Style center

  Centers the text.

Supported Platforms

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

classDefaultStyle

      public:
      static const Style classDefaultStyle

  Provides the original default style for this class, which is the following: IStaticText::left | IStaticText::top | IStaticText::fillBackground | IWindow::visible.

Supported Platforms

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

fillBackground

      public:
      static const Style fillBackground

  Erases the background, using the currently set fill color, before drawing the text.

Supported Platforms

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

AIX Considerations

  In AIX, the background is always painted regardless of this style setting.

halftone

      public:
      static const Style halftone

  Draws the text in halftone color.

Supported Platforms

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

left

      public:
      static const Style left

  Left-justifies the text.

Supported Platforms

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

mnemonic

      public:
      static const Style mnemonic

  If a mnemonic prefix character (the tilde) is found, the character following the prefix character is drawn with mnemonic emphasis. Without the mnemonic style, the tilde is displayed in the text of the IStaticText object.

Supported Platforms

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

right

      public:
      static const Style right

  Right-justifies the text.

Supported Platforms

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

strikeout

      public:
      static const Style strikeout

  Draws the text with a line through it.

Supported Platforms

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

top

      public:
      static const Style top

  Aligns the text at the top of the window.

Supported Platforms

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

underscore

      public:
      static const Style underscore

  Underlines the text.

Supported Platforms

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

vertCenter

      public:
      static const Style vertCenter

  Aligns the text vertically in the center of the window.

Supported Platforms

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

wordBreak

      public:
      static const Style wordBreak

  Word-wraps, at ends of lines, text that has multiple lines. You can only use this style when you also specify the left and top styles.

Supported Platforms

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

AIX Considerations

  The Open Class Library creates objects of the IStaticText class using XmLabel widgets.

  The wordBreak style is ignored when the text contains multi-byte character set (MBCS) or double-byte character set (DBCS) data.

### Text Processing

Use these members to set the text, to query the text, and to modify how the text is displayed for the static text control.

disableHalftone

      public:
      virtual IStaticText& disableHalftone()

  Removes the halftone from the text.

Supported Platforms

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

AIX Considerations

  The halftone style is not available in AIX; therefore, this function has no effect.

disableStrikeout

      public:
      virtual IStaticText& disableStrikeout()

  Removes the line drawn through the text.

Supported Platforms

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

AIX Considerations

  The strikeout style is not available in AIX; therefore, this function has no effect.

disableUnderscore

      public:
      virtual IStaticText& disableUnderscore()

  Removes the line beneath the text.

Supported Platforms

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

AIX Considerations

  The underscore style is not available in AIX; therefore, this function has no effect.

enableHalftone

      public:
      virtual IStaticText& enableHalftone(bool enable = true)

  Draws the text using the style halftone.

Supported Platforms

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

AIX Considerations

  The halftone style is not available in AIX; therefore, this function has no effect.

enableStrikeout

      public:
      virtual IStaticText& enableStrikeout(bool enable = true)

  Draws a line through the text.

Supported Platforms

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

AIX Considerations

  The strikeout style is not available in AIX; therefore, this function has no effect.

enableUnderscore

      public:
      virtual IStaticText& enableUnderscore(bool enable = true)

  Draws a line beneath the text.

Supported Platforms

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

AIX Considerations

  The underscore style is not available in AIX; therefore, this function has no effect.

isHalftone

      public:
      bool isHalftone() const

  If the text has the style halftone set, true is returned. Otherwise, false is returned.

Supported Platforms

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

AIX Considerations

  The halftone style is not available in AIX. This function returns false.

isStrikeout

      public:
      bool isStrikeout() const

  If the text has the style strikeout set, true is returned. Otherwise, false is returned.

Supported Platforms

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

AIX Considerations

  The strikeout style is not available in AIX. This function returns false.

isUnderscore

      public:
      bool isUnderscore() const

  If the text has the style underscore set, true is returned. Otherwise, false is returned.

Supported Platforms

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

AIX Considerations

  The underscore style is not available in AIX. This function returns false.

setText

  Sets the text for the control. Overrides the inherited setText. If appropriate, this function also notifies a parent canvas to update the layout for its children.

  Overload 1

      public:
      virtual IStaticText& setText(const IResourceId& text)

  Use this function to set the text in the static text control using an IResourceId.

Supported Platforms

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

  Overload 2

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

  Use this function to set the text in the static text control using a character string.

Supported Platforms

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

text

      public:
      virtual IString text() const

  Returns the control window's text.

Supported Platforms

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

### IStaticText - Enumerations

Alignment

      enum Alignment { topLeft,
                       topLeftWrapped,
                       topCenter,
                       topRight,
                       centerLeft,
                       centerCenter,
                       centerRight,
                       bottomLeft,
                       bottomCenter,
                       bottomRight }

  Use these enumerators to specify the alignment of the static text:

  topLeft
    Aligns the text at the top of the window and left-justifies the text.
  topLeftWrapped
    Aligns the text at the top of the window, left-justifies the text, and wraps the text into multiple lines using word-wrapping at the end of the lines.
  topCenter
    Aligns text at the top of the window and centers it.
  topRight
    Aligns text at the top of the window and right-justifies it.
  centerLeft
    Aligns text vertically in the center of the window and left-justifies it.
  centerCenter
    Aligns text vertically in the center of the window and centers it.
  centerRight
    Aligns text vertically in the center of the window and right-justifies it.
  bottomLeft
    Aligns text at the bottom of the window and left-justifies it.
  bottomCenter
    Aligns text at the bottom of the window and centers it.
  bottomRight
    Aligns text at the bottom of the window and right-justifies it.

Supported Platforms

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

AIX Considerations

  The topLeftWrapped enumerator is equivalent to the topLeft enumerator when the text contains multi-byte character set (MBCS) or double-byte character set (DBCS) data.

### IStaticText - 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)

  -     virtual unsigned long textLength() const

  IWindow

  -     virtual ~IWindow()

  -     IAccelTblHandle acceleratorHandle() const

  -     IAcceleratorTable acceleratorTable() const

  -     virtual IColor activeColor() 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 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

  -     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 IWindowHandle handle() 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 IColor inactiveColor() 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

  -     virtual bool isValid() 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 IRectangle nativeRect() const

  -     virtual INotifierAddress notifierAddress() const

  -     virtual IWindow&
          notifyObservers( const INotificationEvent& event )

  -     virtual IWindow&
          notifyObserversAsync( const INotificationEvent& event )

  -     static IWindow* objectWindow()

  -     virtual IWindow* owner() const

  -     IWindow* parent() const

  -     virtual ISize parentSize() 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( EventType eventType,
                     const IEventParameter1& parm1 = 0,
                     const IEventParameter2& parm2 = 0 ) const

  -     virtual const IWindow& postEvent(const IEvent& event) 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)

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

  -     IColor color(unsigned long colorArea) const

  -     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,
                  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,
                  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 )

  -     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 ( ) )

  -     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 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