Amiga Unix — 68040 · 68060

Manual pages › Libraries: curses, OPEN LOOK and others (3)

olBuletinbrd(3)

BulletinBoard

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

WIDGET CLASS NAME

BulletinBoard

SYNOPSIS

#include <Intrinsic.h>
#include <StringDefs.h>
#include <OpenLook.h>
#include <BulletinBo.h>
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  chil-
dren.   It displays an empty space, possibly surrounded by a
border.
Keyboard Traversal Users can traverse among Text  and  Text-
Field  widgets  within  any  ancestor ControlArea, Bulletin-
Board, 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.

Amiga Unix                Last change:                          1

          BulletinBoard  Coloration  Figure  1  illustrates   the
          resources  that  affect the coloration of the Bulletin-
          Board widget.
                   Figure 1.  Bulletin Board Coloration

Amiga Unix                Last change:                          2

RESOURCES

     ______________________________________________________________________________________
     ___________________________BulletinBoard_Resource_Set\*(cO____________________________
      Name                   Class                  Type             Default        Access
     ______________________________________________________________________________________

Amiga Unix                Last change:                          3
()                MISC. REFERENCE MANUAL PAGES                 ()

     ______________________________________________________________________________________
     _XtNancestorSensitive___XtCSenstitive__________Boolean__________TRUE___________G*_____
    | XtNbackground          XtCBackground          Pixel            White          SGI-  |
    |_____________________|______________________|________________|______________|________|
    |_XtNbackgroundPixmap_|__XtCPixmap___________|__Pixmap________|__(none)______|__SGI-__|
    | XtNborderColor      |  XtCBorderColor      |  Pixel         |  Black       |  SGI-  |
    |_____________________|______________________|________________|______________|________|
    |_XtNborderPixmap_____|__XtCPixmap___________|__Pixmap________|__(none)______|__SGI-__|
    | XtNborderWidth      |  XtCBorderWidth      |  Dimension     |  0           |  SGI   |
    |_____________________|______________________|________________|______________|________|
    |_XtNdepth____________|__XtCDepth____________|__int___________|__(parent's)__|__GI____|
    | XtNdestroyCallback  |  XtCCallback         |  XtCallbackList|  NULL        |  SI    |
    |_____________________|______________________|________________|______________|________|
    |_XtNheight___________|__XtCHeight___________|__Dimension_____|__(calculated)|__SGI___|
    | XtNlayout           |  XtCLayout           |  OlDefine      |  OL_MINIMIZE |  SGI   |
    |_____________________|______________________|________________|______________|________|
    |_XtNmappedWhenManaged|__XtCMappedWhenManaged|__Boolean_______|__TRUE________|__SGI___|
    | XtNsensitive        |  XtCSensitive        |  Boolean       |  TRUE        |  GI*   |
    |_____________________|______________________|________________|______________|________|
    |_XtNtraversalManager_|__XtCTraversalManager_|__Boolean_______|__FALSE_______|__SGI___|
    | XtNuserData         |  XtCUserData         |  XtPointer     |  NULL        |  SGI   |
    |_____________________|______________________|________________|______________|________|
    |_XtNwidth____________|__XtCWidth____________|__Dimension_____|__(calculated)|__SGI___|
    | XtNx                |  XtCPosition         |  Position      |  0           |  SGI   |
    |_____________________|______________________|________________|______________|________|
    |_XtNy________________|__XtCPosition_________|__Position______|__0___________|__SGI___|

     XtNlayout

     Range of Values:
          OL_MINIMIZE/"minimize"
          OL_MAXIMIZE/"maximize"
          OL_IGNORE/"ignore"

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

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

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

             The BulletinBoard widget  will  ask  for  additional

Amiga Unix                Last change:                          1
()                MISC. REFERENCE MANUAL PAGES                 ()

space when it needs it for new or altered children, but will not give up extra space. XtNtraversal-Manager

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

Amiga Unix                Last change:                          2