Reference Guide > W Routines > WoLabeledText Function
  

WoLabeledText Function
Creates a group of aligned text widgets (widgets with a label and a text field).
Usage
widget = WoLabeledText(parent, label_names, verify_callback)
Input Parameters
parent — Specifies the parent widget ID of the text widget (long).
label_names — Specifies an array of strings containing the names of the label widgets.
verify_callback — Specifies a string containing the name of the text verification callback.
Returned Value
widget — The widget ID of the container widget (long).
Input Keywords
Cols — Specifies the number of columns in the text widgets. (Default: 10)
Horizontal — If nonzero, aligns the text widgets horizontally. (Default: vertical alignment)
Layout_Name — Specifies a string containing the name of the container widget.
Position — A two-element array specifying the x, y coordinates of the text widgets in the bulletin board. (Default: [0,0])
Text_Names — Specifies a string array containing the names of the text widgets. (Default: ['text_0', 'text_1', ...])
Text_Strings — Specifies a string array containing the initial contents of the text widgets.
Output Keywords
Text_Widgets — An array of widget IDs for the text widgets.
Attachment Keywords
Bottom — If a widget ID is specified (for example, Bottom=wid), then the bottom of the text widget is attached to the top of the specified widget. If no widget ID is specified (for example, /Bottom), then the bottom of the text widget is attached to the bottom of the parent widget.
Left — If a widget ID is specified (for example, Left=wid), then the left side of the text widget is attached to the right side of the specified widget. If no widget ID is specified (for example, /Left), then the left side of the text widget is attached to the left side of the parent widget.
Right — If a widget ID is specified (for example, Right=wid), then the right side of the text widget is attached to the left side of the specified widget. If no widget ID is specified (for example, /Right), then the right side of the text widget is attached to the right side of the parent widget.
Top — If a widget ID is specified (for example, Top=wid), then the top of the text widget is attached to the bottom of the specified widget. If no widget ID is specified (for example, /Top), then the top of the text widget is attached to the top of the parent widget.
Discussion
The number of text fields is determined by the number of elements in the label_names parameter.
The text fields are vertically-aligned unless Horizontal is specified.
Example
This example creates a group of vertically aligned text widgets. The text field labels can be obtained from a resource file.
PRO ValueChangedCB, wid, which
   ...
   ; This callback is called if user types <Return> within one 
   ; of the text widgets. The value will be a PV-WAVE string, 
   ; identical to the value returned from WwText.
   value = WwGetValue (wid)
   print, value
   ...
END
 
PRO CreateStuff
   ...
   top = WwInit ('example', 'Example', layout)
   ; Create a group of vertically aligned text widgets. The label
   ; strings will be blank unless they are loaded from a resource 
   ; file or the X resource database. The label strings should 
   ; be specified in resources, such as:
      *distance.labelString: Distance
      *velocity.labelString: Velocity
      *acceleration.labelString: Acceleration
   textWids = WoLabeledText (layout, ['distance', 'velocity', $
      'acceleration'], 'ValueChangedCB')
   ...
   status = WwSetValue (top, /Display)
   WwLoop
END
See Also
WwInit

Version 2017.0
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.