# 
# gls.info - User interface object help text.
# This file was generated by `gxv' from `gls.G'.
# DO NOT EDIT BY HAND.
# 
:controls1
Devguide: Scrolling Lists

This is the property window for scrolling 
lists.  Changing attributes in this window
allows you to change the appearance of the 
selected scrolling list.
# 
:list
Scrolling Lists scrolling list:

The Scrolling Lists scrolling list shows all
the scrolling lists available in the
currently open user interface.  Click SELECT
on the name of the scrolling list you wish to
edit.  The controls below change to show the
settings of the scrolling list.
# 
:name
Name text field:

The Name text field displays the C name of
the scrolling list.  Gxv uses this name when
it generates source code to create the
scrolling list.  Click SELECT on the text
field, then enter the name you wish to give
the scrolling list.
# 
:label
Label text field:

The Label text field displays text of the
label that appears next to the scrolling
list, or the filename of a glyph that appears
next to the scrolling list, depending on the
setting in the Label Is line below.  Click
SELECT on the text field, then enter the
label or filename you wish to use.
# 
:title
Title:

Allows you to put a name on a scrolling list.
Click SELECT on the text field, then enter 
the title you wish to use.

# 
:label_type
Label Is line:

The Label Is line determines whether the
label is text or a glyph.  Choose Text to set
a text label; choose Glyph Filename to set a
Glyph.  If you set a glyph, you must enter
the glyph's filename in the Label text field.
This line also determines the label's
position.  Choose Left to set the label to
the left of the scrolling list; choose Above to
set the label above the scrolling list.
# 
:layout
Label Is line:

The Label Is line determines whether the
label is text or a glyph.  Choose Text to set
a text label; choose Glyph Filename to set a
Glyph.  If you set a glyph, you must enter
the glyph's filename in the Label text field.
This line also determines the label's
position.  Choose Left to set the label to
the left of the scrolling list; choose Above to
set the label above the scrolling list.
# 
:location_label
Location line (including the X and Y text
fields):

The Location line lists the location of the
upper left corner of the scrolling list from
the upper left corner of the control area
that contains it.  It uses X and Y
coordinates (measured in pixels).  Click
SELECT on the X or Y text field and change
the value there to change the horizontal or
vertical location of the scrolling list.
# 
:location_x
Location line (including the X and Y text
fields):

The Location line lists the location of the
upper left corner of the scrolling list from
the upper left corner of the control area
that contains it.  It uses X and Y
coordinates (measured in pixels).  Click
SELECT on the X or Y text field and change
the value there to change the horizontal or
vertical location of the scrolling list.
# 
:location_y
Location line (including the X and Y text
fields):

The Location line lists the location of the
upper left corner of the scrolling list from
the upper left corner of the control area
that contains it.  It uses X and Y
coordinates (measured in pixels).  Click
SELECT on the X or Y text field and change
the value there to change the horizontal or
vertical location of the scrolling list.
# 
:width
Width text field:

The Width text field specifies the width of
the scrolling list in pixels.  Click SELECT
on the text field and use the keyboard to
enter the width you want.
# 
:rows
Rows text field:

The Rows text field sets the height of the
scrolling list in rows.  Click SELECT on the
text field and use the keyboard to enter the
height you want.
# 
:read_only
Operation setting:

The Operation setting sets the way the user
can use the scrolling list.  Choose Read-
write to allow the user to select a list item
and change it.  Choose Read-only to protect
the list items from user changes.
# 
:selections_required
Choice setting:

The Choice setting determines whether the
scrolling list has to have at least one
choice selected or to have no choices
selected.  Choose Not Required to require no
choices; choose Required to require at least
one choice.
# 
:multiple_selections
Choices setting:

The Choices setting determines whether the
user can choose only one item from the list
or more than one item.  Choose Exclusive to
limit the user to one item; choose
Nonexclusive to allow the user to choose more
then one item.
# 
:init_state
Initial State:

Allows you to specify the state of the scrolling
list when it first appears in your interface.
Choose Active to have the list showing. Choose
Inactive if you want the list grayed out.
Choose Invisible to not show the list.
# 
:default_drop_site
Default Drop Site:

SELECT this setting to make this list the default 
drop site.  Drops dropped upon the application 
when it is iconified will be redirected to this 
drop site.  You will need to use the Connections 
Manager to generate a handler for the DroppedUpon 
event to make this list a drop site (see the 
Connections Manager).
# 
:menu_button
Menu Button:

Allows you to choose a menu to attach to the 
scrolling list. In the menu, you can choose
New to create a new menu, or Names to choose
an already existing menu. Click MENU to get the 
menu. Choose the Apply button to apply your menu.
# 
:menu_name
Menu Name Textfield:

SELECT this lfield to enter a menu name. You can
also use the menu button to enter names here.
# 
:color_button
The Color line (includes button and text
field):

The Color line sets the color of the
scrolling list.  Click SELECT on the Color
button to open the Color Chooser window,
where you can choose a new color; or click
SELECT on the text field following the
button, and enter a proper XView color name
to set a new color.
# 
:color_sploch
Color Glyph:

Displays the color you selected in the color
menu (or palette). SELECT the Apply button to
apply the menu.
# 
:color
The Color Line (includes button and text
field):

the color line sets the color of the
scrolling list.  click select on the color
button to open the color chooser window,
where you can choose a new color; or click
select on the text field following the
button, and enter a proper xview color name
to set a new color.
# 
:help_button
The Help Text Button:

Click select on the help text button to open
the help editor window, where you can enter
and edit help text to be attached to the
scrolling list.
# 
:connections
Connections Button:

SELECTing this button brings up the Connections
Manager for the selected scrolling list. It lets
you associate a handler to the scrolling list.
# 
:controls2
Devguide: Scrolling Lists

This is the property window for scrolling 
lists.  Changing attributes in this window
allows you to change the appearance of the 
selected scrolling list.
# 
:item_list
Items Scrolling List:

This list contains the items appearing in the 
selected scrolling list. Choosing an item
already appearing in the list allows you change
the label. SELECTing another item or pressing
Apply, applies your changes.
# 
:item_insert
The Insert menu button:

The Insert menu button contains items that
insert choices in the Choices scrolling list.
Click MENU to open the button menu.
# 
:item_edit
The Edit menu button:

The Edit menu button contains items that cut,
copy, and paste choices in the Choices
scrolling list.  Click MENU to open the
button menu.
# 
:item_label
The Label text field:

The Label text field contains the name of the
choice currently selected in the Choices
scrolling list.  Click SELECT on the text
field and use the keyboard to change the
label.  Choose the Apply button or select
another choice in the scrolling list to apply
your label change.
# 
:item_glyph
Glyph Label:

Allows you to specify a glyph to use as an item
in a scrolling list. Labels and glyphs may
reside as one item in a scrolling list.

# 
:item_selected
Item Is:

The Item Is settings allow you to choose 
items that are selected or not selected
when the setting is first displayed. 
SELECT Not Selected if you do not want the item 
to appear selected; SELECT Selected if 
you do want this item selected.
# 
:controls3
Devguide: Scrolling Lists

This is the property window for scrolling 
lists.  Changing attributes in this window
allows you to change the appearance of the 
selected scrolling list.
# 
:apply
The Apply button:

The Apply button applies any changes you've
made to a scrolling list's properties.  Click
SELECT on it to apply changes.
# 
:reset
The Reset button:

The Reset button returns any changed
scrolling list properties to their settings
as they appeared when you last used the Apply
button or when you selected a new name in the
Scrolling Lists scrolling list (which has the
same effect as choosing the Apply button.)
Click SELECT on the Reset button to reset
properties.
