WIDGET CLASS NAME

BulletinBoard

SYNOPSIS

#include <Intrinsic.h>
#include <Intrinsic.h>
#include <StringDefs.h>
#include <OpenLook.h>
#include <BulletinBo.h>

widget = XtCreateWidget(name, bulletinBoardWidgetClass, ...);
widget = XtCreateWidget(name, bulletinBoardWidgetClass, ...);

DESCRIPTION

Simple Composite Widget

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.  No Children

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

Users can traverse among Text and TextField widgets within any ancestor ControlArea, BulletinBoard, or Form widget using the NEXTFIELD and PREVFIELD keys:

—NEXTFIELD moves the caret to the next traversable Text or TextField widget in the managing ancestor widget.  When the caret is in the last traversable field, NEXTFIELD moves the caret to the first traversable field. 

—PREVFIELD moves the caret to the previous traversable field in the managing ancestor widget.  When the caret is in the first traversable field, PREVFIELD moves the caret to the last traversable field. 

The default key mappings for NEXTFIELD and PREVFIELD are TAB and SHIFT-TAB, respectively.  A user may change these defaults through the appropriate Workspace Properties window. 
BulletinBoard Coloration

The diagram Bulletin Board Coloration illustrates the resources that affect the coloration of the BulletinBoard widget. 

  Figure 1 Bulletin Board Coloration

RESOURCES

  Table 1 BulletinBoard Resource Set BulletinBoard Resource Set\\∗(cO
                Name            Type       Default   Access XtNancestorSensitive         Boolean          TRUE       G∗
       XtNbackground           Pixel         White  SGI†
 XtNbackgroundPixmap          Pixmap        (none)  SGI†
      XtNborderColor           Pixel         Black  SGI†
     XtNborderPixmap          Pixmap        (none)  SGI†
      XtNborderWidth       Dimension             0      SGI
            XtNdepth             int    (parent’s)       GI
  XtNdestroyCallback  XtCallbackList          NULL       SI
           XtNheight       Dimension  (calculated)      SGI XtNmappedWhenManaged         Boolean          TRUE      SGI
        XtNsensitive         Boolean          TRUE      GI∗
 XtNtraversalManager         Boolean         FALSE      SGI
         XtNuserData       XtPointer          NULL      SGI
            XtNwidth       Dimension  (calculated)      SGI
                XtNx        Position             0      SGI
                XtNy        Position             0      SGI XtNlayout

Range of Values:

OL_MINIMIZE/"minimize"
OL_MINIMIZE/"minimize"
OL_MAXIMIZE/"maximize"
OL_IGNORE/"ignore"

This resource identifies the layout policy the BulletinBoard widget is to follow:

OL_MINIMIZE

OL_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

OL_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

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

XtNtraversalManager This resource controls whether this widget manages traversal for its descendants.

Sun Release 4.1  —  Last change: 1/8/90