408 Appendix B: iTool Compound Widgets
CW_ITSTATUSBAR iTool Developer’s Guide
CW_ITSTATUSBAR
The CW_ITSTATUSBAR function creates an iTool status bar compound widget that
will contain any status bars registered with the specified IDLitUI object’s associated
iTool. See “Status Messages” on page 287 for additional details on status bars.
Warning
This routine can only be used in the context of a user-created iTool. See “Overview
of iTools Compound Widgets” on page 398 for details.
The CW_ITSTATUSBAR widget automatically performs the following actions:
1. Creates a base widget to contain the status bars.
2. Constructs any status bars registered with the iTool using label widgets. See
IDLitTool::RegisterStatusBarSegment for details.
3. Adds itself as an observer of each status bar segment object. The
CW_ITSTATUSBAR widget listens for the following message:
See “iTool Messaging System” on page 41 for a discussion of observers and
notifications.
Tip
By default, iTools include two status bar segments. The StatusMessage and
ProbeStatusMessage methods of the IDLitIMessaging class can be used to
automatically send the MESSAGE callback to the appropriate status bar segment.
See “Status Messages” on page 287 for details.
Resizing CW_ITSTATUSBAR Widgets
The CW_ITSTATUSBAR widget does not automatically resize itself to the size of its
parent widget. To resize the CW_ITSTATUSBAR widget, your event handling code
must call the CW_ITSTATUSBAR_RESIZE procedure to specify the new size. The
CW_ITSTATUSBAR_RESIZE procedure has the following interface:
CW_ITSTATUSBAR_RESIZE, Widget_ID, Xsize
Message Value Description / Result
MESSAGE String Change the text of the status bar segment.
Table B-3: Messages Understood by CW_ITSTATUSBAR
