NAME

BulletinBoard − bulletin board widget

SYNOPSIS

#include <Xol/BulletinBo.h>
#include <Xol/OpenLook.h>
 . . .

ANCESTRY

 Core-Composite-Constraint-Manager-BulletinBoard

DESCRIPTION

The BulletinBoard widget is a composite widget that enforces no ordering on its children.  It is up to the application to specify the x and y coordinates of each child inserted. Otherwise, it will be placed in the upper left corner of the BulletinBoard widget. 

  Figure 1 Bulletin Board Widget

The BulletinBoard can be mapped with no children.  It displays an empty space, possibly surrounded by a border. 

Keyboard Traversal

The BulletinBoard widget is a Composite widget and cannot be accessed via keyboard traversal.  Input focus moves between the Primitive children of this widget. 

Coloration

of the BulletinBoard widget. 

  Figure 2 Bulletin Board Coloration

RESOURCES

  Table 1 BulletinBoard Resource Summary

Name                     Type            Default             Access
XtNancestorSensitive-   Boolean          TRUE                  GO
XtNbackground-          Pixel            XtDefaultBackground   SGI
XtNbackgroundPixmap-    Pixmap           (none)                SGI
XtNborderColor-         Pixel            XtDefaultForeground   SGI
XtNborderPixmap-        Pixmap           (none)                SGI
XtNborderWidth-         Dimension        0                     SGI
XtNconsumeEvent-        XtCallbackList   NULL                  SG
XtNdepth-               int              (parent’s)            GI
XtNdestroyCallback-     XtCallbackList   NULL                  SI
XtNheight-              Dimension        (calculated)          SGI
XtNinputFocusColor-     Pixel            Red                   SGI
XtNlayout               OlDefine         OL_MINIMIZE           SGI
XtNmappedWhenManaged-   Boolean          TRUE                  SGI
XtNsensitive-           Boolean          TRUE                  GIO
XtNuserData-            XtPointer        NULL                  SGI
XtNwidth-               Dimension        (calculated)          SGI
XtNx-                   Position         0                     SGI
XtNy-                   Position         0                     SGI

Access:   S = XtSetValues   G = XtGetValues
            I = init time   O = other access † see resources(3W)

XtNlayout

class:XtCLayout type:OlDefine default:OL_MINIMIZEaccess:SGI

Action: identifies the layout policy the BulletinBoard widget is to follow:

OL_MINIMIZE/"minimize" – the BulletinBoard widget will always be just large enough to contain all its children, regardless of any provided width and height values.  Thus the BulletinBoard widget will grow and shrink depending on the size needs of its children. 

OL_IGNORE/"ignore" – the BulletinBoard widget will honor its own width and height; it will not grow or shrink in response to the addition, deletion, or altering of its children. 

OL_MAXIMIZE/"maximize"  – the BulletinBoard widget will ask for additional space when it needs it for new or altered children, but will not give up extra space. 

SEE ALSO

resources(3W)

Version 3.0.1  —  Last change: June 92