Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dwtlabelgadgetcreate(3dwt) [ultrix man page]

DwtLabelGadgetCreate(3Dwt)												DwtLabelGadgetCreate(3Dwt)

       DwtLabelGadgetCreate - Creates a label gadget.

       Widget DwtLabelGadgetCreate (parent_widget, name,
				    override_arglist, override_argcount)
	    Widget parent_widget;
	    char *name;
	    ArgList override_arglist;
	    int override_argcount;

		 Specifies the parent widget ID.

       name	 Specifies the name of the created widget.

		 Specifies the application override argument list.

		 Specifies the number of attributes in the application override argument list (override_arglist).

       The  DwtLabelGadgetCreate function creates an instance of the label gadget and returns its associated gadget ID.  A label gadget is similar
       in appearance and semantics to a label widget.  Like all gadgets, the label gadget does not have a window but uses the window of the  clos-
       est  antecedent	widget.   Thus,  the antecedent widget provides all event dispatching for the gadget.  This currently restricts gadgets to
       being descendents of menu or dialog class (or subclass) widgets.  Drawing information such as font and color are also those of the  closest
       antecedent widget.

Inherited Attributes
       Attribute Name	       Data Type   Default
       Rectangle Attributes
       DwtNx		       Position    Determined	by
					   the	  geometry
       DwtNy		       Position    Determined	by
					   the	  geometry
       DwtNwidth	       Dimension   The	 width	of
					   the label  plus
       DwtNheight	       Dimension   The	height	of
					   the label  plus
       DwtNborderWidth	       Dimension   zero pixels
       DwtNsensitive	       Boolean	   True
       DwtNancestorSensitive   Boolean	   The bitwise AND
					   of  the  parent
					   and	DwtNances-

Widget-Specific Attributes
       Attribute Name	   Data Type	    Default

       DwtNlabel	   DwtCompString    Widget name
       DwtNalignment	   unsigned char    DwtAlignment-
       DwtNdirectionRToL   Boolean	    False
       DwtNhelpCallback    DwtCallbackPtr   NULL

       DwtNlabel      Specifies the label for the text style.

       DwtNalignment  Specifies the label alignment for text style.  You can pass  DwtAlignmentCenter  (center	alignment),  DwtAlignmentBeginning
		      (alignment at the beginning), or DwtAlignmentEnd (alignment at the end).

		      Specifies a boolean value that, when False, indicates that the text is drawn from left to right.	If True, the text is drawn
		      from right to left.

		      Specifies the callback function or functions called when a help request is made.

Return Values
       This function returns the ID of the created widget.

Callback Information
       The following structure is returned to your callback:
       typedef struct {
			int reason;
			XEvent *event;
       } DwtAnyCallbackStruct;

       The reason member is set to a constant that represents the reason why this callback was invoked.  For this callback, the reason member  can
       be set to:

       DwtCRHelpRequested   The user selected Help.

       The  event  member  is a pointer to the Xlib structure XEvent, which describes the event that generated this callback.  This structure is a
       union of the individual structures declared for each event type.  For information on XEvent and event processing, see the Guide to the Xlib
       Library: C Language Binding.

See Also
       Guide to the XUI Toolkit: C Language Binding
       Guide to the XUI Toolkit Intrinsics: C Language Binding

Man Page