*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> XmBulletinBoard (3X)              
Title
Content
Arch
Section
 

XmBulletinBoard(3X)

Contents


NAME    [Toc]    [Back]

       XmBulletinBoard - The BulletinBoard widget class

SYNOPSIS    [Toc]    [Back]

       #include <Xm/BulletinB.h>


DESCRIPTION    [Toc]    [Back]

       BulletinBoard  is  a composite widget that provides simple
       geometry management for  children  widgets.  It  does  not
       force  positioning  on  its  children,  but  can be set to
       reject geometry requests that result in overlapping  children.
  BulletinBoard  is  the  base widget for most dialog
       widgets and is also used as a general container widget.

       Modal and modeless dialogs are implemented as  collections
       of widgets that include a DialogShell, a BulletinBoard (or
       subclass) child of the shell, and  various  dialog  components
 (buttons, labels, etc.) that are children of BulletinBoard.
  BulletinBoard  defines  callbacks   useful   for
       dialogs  (focus,  map,  unmap),  which  are  available for
       application use. If its parent is a  DialogShell,  BulletinBoard
  passes  title  and  input  mode  (based on dialog
       style) information to the parent, which is responsible for
       appropriate communication with the window manager.

       The default value for XmNinitialFocus is the value of XmNdefaultButton.


   Classes    [Toc]    [Back]
       BulletinBoard inherits behavior and resources  from  Core,
       Composite, Constraint, and XmManager classes.

       The class pointer is xmBulletinBoardWidgetClass.

       The class name is XmBulletinBoard.

   New Resources    [Toc]    [Back]
       The following table defines a set of widget resources used
       by the programmer to specify  data.   The  programmer  can
       also  set the resource values for the inherited classes to
       set attributes for this widget.  To reference  a  resource
       by  name  or by class in a .Xdefaults file, remove the XmN
       or XmC prefix and use the remaining letters.   To  specify
       one  of  the defined values for a resource in a .Xdefaults
       file, remove the Xm prefix and use the  remaining  letters
       (in  either lowercase or uppercase, but include any underscores
 between words). The  codes  in  the  access  column
       indicate if the given resource can be set at creation time
       (C), set by using  XtSetValues  (S),  retrieved  by  using
       XtGetValues (G), or is not applicable (N/A).

       XmBulletinBoard Resource Set    [Toc]    [Back]

       Class: XmCAllowOverlap
       Default: True
       Type:  Boolean
       Access: CSG
       Class: XmCAutoUnmanage
       Default: True
       Type:  Boolean
       Access: CG
       Class: XmCButtonFontList
       Default: dynamic
       Type:  XmFontList
       Access: CSG
       Class: XmCWidget
       Default: NULL
       Type:  Widget
       Access: SG
       Class: XmCWidget
       Default: NULL
       Type:  Widget
       Access: SG
       Class: XmCDefaultPosition
       Default: True
       Type:  Boolean
       Access: CSG
       Class: XmCDialogStyle
       Default: dynamic
       Type:  unsigned char
       Access: CSG
       Class: XmCDialogTitle
       Default: NULL
       Type:  XmString
       Access: CSG
       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C
       Class: XmCLabelFontList
       Default: dynamic
       Type:  XmFontList
       Access: CSG
       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C
       Class: XmCMarginHeight
       Default: 10
       Type:  Dimension
       Access: CSG
       Class: XmCMarginWidth
       Default: 10
       Type:  Dimension
       Access: CSG
       Class: XmCNoResize
       Default: False
       Type:  Boolean
       Access: CSG
       Class: XmCResizePolicy
       Default: XmRESIZE_ANY
       Type:  unsigned char
       Access: CSG
       Class: XmCShadowType
       Default: XmSHADOW_OUT
       Type:  unsigned char
       Access: CSG
       Class: XmCTextFontList
       Default: dynamic
       Type:  XmFontList
       Access: CSG
       Class: XmCTranslations
       Default: NULL
       Type:  XtTranslations
       Access: C
       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C

              Controls  the  policy for overlapping children widgets.
  If  True,  BulletinBoard   allows   geometry
              requests that result in overlapping children.  Controls
 whether or not BulletinBoard is automatically
              unmanaged  after  a  button  is  activated. If this
              resource is True on initialization and if the  BulletinBoard's
 parent is a DialogShell, BulletinBoard
              adds a callback to  button  children  (PushButtons,
              PushButtonGadgets, and DrawnButtons) that unmanages
              the BulletinBoard when a button  is  activated.  If
              this  resource is False on initialization or if the
              BulletinBoard's parent is not  a  DialogShell,  the
              BulletinBoard  is  not automatically unmanaged. For
              BulletinBoard subclasses with Apply  or  Help  buttons,
  activating  those buttons does not automatically
 unmanage the  BulletinBoard.   Specifies  the
              font  list  used for BulletinBoard's button descendants.
  If this value is  NULL  at  initialization,
              the font list is initialized by looking up the parent
 hierarchy of the widget for an ancestor that is
              a  subclass of the XmBulletinBoard, VendorShell, or
              XmMenuShell widget class.  If such an  ancestor  is
              found,  the font list is initialized to the XmNbuttonFontList
 of the ancestor  widget.   If  no  such
              ancestor  is  found,  the default is implementation
              dependent.  Refer to XmFontList(3X) for more information
  on  the  creation  and  structure of a font
              list.  Specifies the widget ID of the  Cancel  button.
   BulletinBoard's  subclasses,  which define a
              Cancel button, set  this  resource.   BulletinBoard
              does  not  directly  provide  any behavior for that
              button.  Specifies the widget  ID  of  the  default
              button. Some BulletinBoard subclasses, which define
              a default button, set this resource.  BulletinBoard
              defines translations and installs accelerators that
              activate that button when KActivate is pressed  and
              the  keyboard focus is not in another button.  Controls
 whether or not the BulletinBoard is automatically
  positioned  by its parent.  If True, and the
              parent of the BulletinBoard is a  DialogShell,  the
              BulletinBoard is centered within or around the parent
 of the DialogShell when  the  BulletinBoard  is
              mapped and managed.  If False, the BulletinBoard is
              not automatically positioned.  Indicates the dialog
              style  associated  with  the BulletinBoard.  If the
              parent of the BulletinBoard is a  DialogShell,  the
              parent's  XmNmwmInputMode  is  set according to the
              value of this resource. This resource  can  be  set
              only  if  the BulletinBoard is unmanaged.  Possible
              values for this  resource  include  the  following:
              XmDIALOG_SYSTEM_MODAL--used  for  dialogs that must
              be responded to before any other interaction in any
              application               XmDIALOG_PRIMARY_APPLICATION_MODAL--used
 for dialogs that must be responded
              to  before  some other interactions in ancestors of
              the  widget  XmDIALOG_APPLICATION_MODAL--used   for
              dialogs that must be responded to before some other
              interactions in  ancestors  of  the  widget.   This
              value  is  the  same  as  XmDIALOG_PRIMARY_APPLICATION_MODAL,
 and remains for compatibility.   XmDIALOG_FULL_APPLICATION_MODAL--used
  for  dialogs that
              must be responded to before some other interactions
              in the same application XmDIALOG_MODELESS--used for
              dialogs that do not interrupt  interaction  of  any
              application. This is the default when the parent of
              the  BulletinBoard  is   a   DialogShell.    XmDIALOG_WORK_AREA--used
 for BulletinBoard widgets whose
              parents are  not  DialogShells.  XmNdialogStyle  is
              forced  to  have  this value when the parent of the
              BulletinBoard is not a DialogShell.  Specifies  the
              dialog  title.   If  this resource is not NULL, and
              the parent of the BulletinBoard is  a  subclass  of
              WMShell, BulletinBoard sets the XmNtitle and XmNtitleEncoding
 of its parent. If  the  only  character
              set in XmNdialogTitle is ISO8859-1, XmNtitle is set
              to the string of the title, and XmNtitleEncoding is
              set to STRING. If XmNdialogTitle contains character
              sets other than ISO8859-1, XmNtitle is set  to  the
              string  of  the  title converted to a compound text
              string,  and  XmNtitleEncoding  is  set   to   COMPOUND_TEXT.
   Specifies  the list of callbacks that
              is called when the BulletinBoard widget or  one  of
              its  descendants accepts the input focus. The callback
 reason is XmCR_FOCUS.  Specifies the font list
              used  for BulletinBoard's label descendants (Labels
              and LabelGadgets).  If this value is NULL  at  initialization,
  the font list is initialized by looking
 up the parent hierarchy of the  widget  for  an
              ancestor that is a subclass of the XmBulletinBoard,
              VendorShell, or XmMenuShell widget class.  If  such
              an  ancestor is found, the font list is initialized
              to the XmNlabelFontList of the ancestor widget.  If
              no such ancestor is found, the default is implementation
 dependent.  Refer to XmFontList(3X) for more
              information on the creation and structure of a font
              list.  Specifies the  list  of  callbacks  that  is
              called only when the parent of the BulletinBoard is
              a DialogShell; in which case, this callback list is
              invoked  when  the  BulletinBoard widget is mapped.
              The callback reason is XmCR_MAP.  DialogShells  are
              usually  mapped  when  the  DialogShell is managed.
              Specifies the minimum spacing in pixels between the
              top  or  bottom edge of BulletinBoard and any child
              widget.  Specifies the minimum  spacing  in  pixels
              between the left or right edge of BulletinBoard and
              any child widget.  Controls whether or  not  resize
              controls  are  included in the window manager frame
              around the BulletinBoard's parent. If set to  True,
              the  mwm  does  not  include resize controls in the
              window manager frame containing the parent  of  the
              BulletinBoard  if  the parent is a subclass of VendorShell.
 If set to False, the window manager frame
              does  include  resize controls. Other controls provided
 by mwm can be included  or  excluded  through
              the  mwm  resources  provided by VendorShell.  Controls
 the policy for  resizing  BulletinBoard  widgets.
  Possible values include the following: XmRESIZE_NONE--fixed
 size XmRESIZE_ANY--shrink or  grow
              as  needed  XmRESIZE_GROW--grow  only Describes the
              shadow  drawing  style  for  BulletinBoard.    This
              resource    can    have   the   following   values:
              XmSHADOW_IN--draws the BulletinBoard shadow so that
              it appears inset. This means that the bottom shadow
              visuals  and  top  shadow  visuals  are   reversed.
              XmSHADOW_OUT--draws  the  BulletinBoard  shadow  so
              that it  appears  outset  XmSHADOW_ETCHED_IN--draws
              the BulletinBoard shadow using a double line giving
              the effect  of  a  line  etched  into  the  window,
              similar      to      the      Separator      widget
              XmSHADOW_ETCHED_OUT--draws the BulletinBoard shadow
              using  a  double  line  giving the effect of a line
              coming out of the window, similar to the  Separator
              widget  Specifies  the  font  list used for BulletinBoard's
 Text and List descendants. If this  value
              is  NULL  at  initialization, the font list is initialized
 by looking up the parent hierarchy of  the
              widget  for  an  ancestor that is a subclass of the
              XmBulletinBoard or VendorShell  widget  class.   If
              such  an  ancestor  is found, the font list is initialized
 to the  XmNtextFontList  of  the  ancestor
              widget.  If  no such ancestor is found, the default
              is    implementation     dependent.    Refer     to
              XmFontList(3X) for more information on the creation
              and structure of a font list.  Adds translations to
              any  Text  widget  or  Text widget subclass that is
              added as a child of BulletinBoard.   Specifies  the
              list of callbacks that is called only when the parent
 of the BulletinBoard is a DialogShell. In  that
              case,  this  callback list is invoked when the BulletinBoard
 widget is unmapped. The callback  reason
              is  XmCR_UNMAP.  DialogShells  are usually unmapped
              when the DialogShell is unmanaged.

   Inherited Resources    [Toc]    [Back]
       BulletinBoard inherits behavior  and  resources  from  the
       following  superclasses.   For  a  complete description of
       each resource, refer to the man page for that  superclass.

       XmManager Resource Set    [Toc]    [Back]

       Class: XmCBottomShadowColor
       Default: dynamic
       Type:  Pixel
       Access: CSG
       Class: XmCBottomShadowPixmap
       Default: XmUNSPECIFIED_PIXMAP
       Type:  Pixmap
       Access: CSG
       Class: XmCForeground
       Default: dynamic
       Type:  Pixel
       Access: CSG
       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C
       Class: XmCHighlightColor
       Default: dynamic
       Type:  Pixel
       Access: CSG
       Class: XmCHighlightPixmap
       Default: dynamic
       Type:  Pixmap
       Access: CSG
       Class: XmCInitialFocus
       Default: dynamic
       Type:  Widget
       Access: CSG
       Class: XmCNavigationType
       Default: XmTAB_GROUP
       Type:  XmNavigationType
       Access: CSG
       Class: XmCShadowThickness
       Default: dynamic
       Type:  Dimension
       Access: CSG
       Class: XmCStringDirection
       Default: dynamic
       Type:  XmStringDirection
       Access: CG
       Class: XmCTopShadowColor
       Default: dynamic
       Type:  Pixel
       Access: CSG
       Class: XmCTopShadowPixmap
       Default: dynamic
       Type:  Pixmap
       Access: CSG
       Class: XmCTraversalOn
       Default: True
       Type:  Boolean
       Access: CSG
       Class: XmCUnitType
       Default: dynamic
       Type:  unsigned char
       Access: CSG
       Class: XmCUserData
       Default: NULL
       Type:  XtPointer
       Access: CSG


       Composite Resource Set    [Toc]    [Back]

       Class: XmCReadOnly
       Default: NULL
       Type:  WidgetList
       Access: G
       Class: XmCInsertPosition
       Default: NULL
       Type:  XtOrderProc
       Access: CSG
       Class: XmCReadOnly
       Default: 0
       Type:  Cardinal
       Access: G


       Core Resource Set    [Toc]    [Back]

       Class: XmCAccelerators
       Default: dynamic
       Type:  XtAccelerators
       Access: N/A
       Class: XmCSensitive
       Default: dynamic
       Type:  Boolean
       Access: G
       Class: XmCBackground
       Default: dynamic
       Type:  Pixel
       Access: CSG
       Class: XmCPixmap
       Default: XmUNSPECIFIED_PIXMAP
       Type:  Pixmap
       Access: CSG
       Class: XmCBorderColor
       Default: XtDefaultForeground
       Type:  Pixel
       Access: CSG
       Class: XmCPixmap
       Default: XmUNSPECIFIED_PIXMAP
       Type:  Pixmap
       Access: CSG
       Class: XmCBorderWidth
       Default: 0
       Type:  Dimension
       Access: CSG
       Class: XmCColormap
       Default: dynamic
       Type:  Colormap
       Access: CG
       Class: XmCDepth
       Default: dynamic
       Type:  int
       Access: CG
       Class: XmCCallback
       Default: NULL
       Type:  XtCallbackList
       Access: C
       Class: XmCHeight
       Default: dynamic
       Type:  Dimension
       Access: CSG
       Class: XmCInitialResourcesPersistent
       Default: True
       Type:  Boolean
       Access: C
       Class: XmCMappedWhenManaged
       Default: True
       Type:  Boolean
       Access: CSG
       Class: XmCScreen
       Default: dynamic
       Type:  Screen *
       Access: CG
       Class: XmCSensitive
       Default: True
       Type:  Boolean
       Access: CSG
       Class: XmCTranslations
       Default: dynamic
       Type:  XtTranslations
       Access: CSG
       Class: XmCWidth
       Default: dynamic
       Type:  Dimension
       Access: CSG
       Class: XmCPosition
       Default: 0
       Type:  Position
       Access: CSG
       Class: XmCPosition
       Default: 0
       Type:  Position
       Access: CSG


   Callback Information    [Toc]    [Back]
       A  pointer  to  the  following structure is passed to each
       callback: typedef struct {
         int      reason;
         XEvent   * event; } XmAnyCallbackStruct;

       Indicates why the callback was  invoked.   Points  to  the
       XEvent that triggered the callback.

   Translations    [Toc]    [Back]
       XmBulletinBoard  includes the translations from XmManager.

   Additional Behavior    [Toc]    [Back]
       The XmBulletinBoard widget  has  the  additional  behavior
       described below: Calls the activate callbacks for the cancel
 button if it is sensitive. If no cancel button  exists
       and  if  the  parent  of  the  BulletinBoard is a manager,
       passes the event to the parent.  Calls the activate  callbacks
 for the button with the keyboard focus. If no button
       has the keyboard focus, calls the activate  callbacks  for
       the default button if it is sensitive. In a List widget or
       single-line Text widget, the List or Text  action  associated
  with  KActivate  is  called before the BulletinBoard
       actions associated with KActivate. In  a  multi-line  Text
       widget,  any  KActivate event except KEnter calls the Text
       action associated with KActivate, then  the  BulletinBoard
       actions  associated  with  KActivate. If no button has the
       focus, no default button exists, and  the  parent  of  the
       BulletinBoard  is  a manager, passes the event to the parent.
  Calls the callbacks for XmNfocusCallback.  When  the
       focus  policy  is XmPOINTER, this happens when the pointer
       enters the window. When the focus  policy  is  XmEXPLICIT,
       this happens when the user traverses to the widget.  Calls
       the callbacks for XmNmapCallback.  Calls the callbacks for
       XmNunmapCallback.

   Virtual Bindings    [Toc]    [Back]
       The  bindings  for  virtual  keys are vendor specific. For
       information about bindings for virtual buttons  and  keys,
       see VirtualBindings(3X).

SEE ALSO    [Toc]    [Back]

      
      
       Composite(3X),  Constraint(3X),  Core(3X), XmCreateBulletinBoard(3X),    XmCreateBulletinBoardDialog(3X),     XmDialogShell(3X), XmManager(3X)



                                              XmBulletinBoard(3X)
[ Back ]
 Similar pages
Name OS Title
XmCreateBulletinBoard Tru64 The BulletinBoard widget creation function
XmCreateBulletinBoard HP-UX The BulletinBoard widget creation function
XmCreateBulletinBoard IRIX The BulletinBoard widget creation function
ApplicationShell IRIX The ApplicationShell widget class
tmscrollbar IRIX the ScrollBar widget class
tmscrolledwindow IRIX the ScrolledWindow widget class
tmselectionbox IRIX the SelectionBox widget class
tmsgigrid IRIX the SGI Grid widget class
tmsgipanel IRIX the SGI IconPanel widget class
tmsgithumbwheel IRIX the SGI sgThumbWheel widget class
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service