Create Routine

The tsol_lbuild_create(3TSOL) routine accepts any widget, Boolean value, callback, and a NULL terminated series of operation and value pairs. A variable of type ModLabelData is returned.

• Widget - Label builder can build the dialog box from any widget.

• Callback function - The callback function activates when the OK pushbutton is pressed. This callback provides application-specific behavior.

• Operation and value pairs - The operation (left) side of the pair specifies an extended operation (see "Extended Operations") and the value (right) side specifies the value. In some cases, the value is an enumerated constant, and in other cases, you provide a value. The pairs can be specified in any order, but every operation you specify requires a valid value.

• The return value is a data structure that contains information on the dialog box just created. The information comes from the tsol_lbuild_create(3TSOL) input parameters and user activities during execution. Label builder provides default values for some fields where no values have been specified.

  Use the tsol_lbuild_get(3TSOL) and tsol_lbuild_set(3TSOL) routines to programmatically access and change the information in this variable. The data structure is described in "ModLabelData Structure".

	data= tsol_lbuild_create( form, callback_function,
		LBUILD_MODE, LBUILD_MODE_CMW,
		LBUILD_TITLE, "Building CMW Label",
		LBUILD_VALUE_CMW, cmwlabel,
		LBUILD_VIEW, LBUILD_VIEW_EXTERNAL
		LBUILD_X, 200,
		LBUILD_Y, 200,
		LBUILD_USERFIELD "/export/home/zelda"
		LBUILD_SHOW, FALSE,
		NULL);