Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MrmFetchWidget(3)	   Library Functions Manual	     MrmFetchWidget(3)

NAME
       MrmFetchWidget  --  Fetches and creates an indexed (UIL named) applica-
       tion widget and its children

SYNOPSIS
       #include	<Mrm/MrmPublic.h>
       Cardinal	MrmFetchWidget(
       MrmHierarchy hierarchy_id,
       String index,
       Widget parent_widget,
       Widget *widget,
       MrmType *class);

DESCRIPTION
       The MrmFetchWidget function fetches and creates an indexed  application
       widget  and its children.  The indexed application widget is any	widget
       that is named in	UIL.  In fetch operations, the fetched	widget's  sub-
       tree  is	 also fetched and created.  This widget	must not appear	as the
       child of	a widget within	its own	subtree. MrmFetchWidget	does not  exe-
       cute XtManageChild for the newly	created	widget.

       All  widgets fetched by a call to MrmFetchWidget	are not	managed	at the
       time of their creation callbacks.

       hierarchy_id
		 Specifies the ID of the UID hierarchy that contains  the  in-
		 terface  definition.	The value of hierarchy_id was returned
		 in a previous call to MrmOpenHierarchyPerDisplay.

       index	 Specifies the UIL name	of the widget to fetch.

       parent_widget
		 Specifies the parent widget ID.

       widget	 Returns the widget ID of the created widget.

       class	 This argument must be set to an actual	pointer; it cannot  be
		 a  NULL  pointer. MrmFetchWidget sets this argument to	an im-
		 plementation dependent	value.

       An application can fetch	any named widget in the	 UID  hierarchy	 using
       MrmFetchWidget.	 MrmFetchWidget	 can  be called	at any time to fetch a
       widget that was not fetched at application startup.  MrmFetchWidget can
       be  used	 to  defer fetching pop-up widgets until they are first	refer-
       enced (presumably in a callback), and then used to fetch	them once.

       MrmFetchWidget can also create multiple instances of a widget (and  its
       subtree).   In this case, the UID definition functions as a template; a
       widget definition can be	fetched	any number of times.   An  application
       can use this template to	make multiple instances	of a widget, for exam-
       ple, in a dialog	box box	or menu.

       The index (UIL name) that identifies the	widget must be	known  to  the
       application.

RETURN
       This function returns one of the	following status return	constants:

       MrmSUCCESS
		 The function executed successfully.

       MrmBAD_HIERARCHY
		 The hierarchy ID was invalid.

       MrmNOT_FOUND
		 The widget was	not found in UID hierarchy.

       MrmFAILURE
		 The function failed.

RELATED
       MrmOpenHierarchyPerDisplay(3), MrmFetchWidgetOverride(3).

							     MrmFetchWidget(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=MrmFetchWidget&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help