Adobe 65007312 - Photoshop Lightroom Programmer's Manual page 86

C 5: Creating a User Interface for Your Plug-in
HAPTER
Control type
checkbox
color_well
combo_box
edit_field
Description
Displays the text with a
title
platform-style checkbox button.
A checkbox is checked (selected) when its
is equal to its
value checked_value
unchecked (deselected) when its
equal to its
unchecked_value
has any other value, the button shows a
mixed state.
See "Binding checkbox selections" on
page 98.
N : The comparison of property values is very specific; the values 0, false, nil, and ""
OTE
(the empty string) are all distinct.
Displays a color, and responds to a click by
displaying a predefined color-selection UI.
An editable text field with a pop-up menu
of predefined text values. User can enter
any text, or select from the menu. When an
item is selected from the menu, its
becomes the control
value
displayed in the text field.
See "Binding combo box selections" on
page 101.
An editable text field. An edit field accepts
keyboard input when it has the input focus.
User input is committed (that is, the
is updated) with every keystroke if
is true. If
immediate immediate
input is committed when the control loses
focus. There is a platform difference in the
focus behavior:
In Windows, the control loses focus
when the user clicks outside it.
In Mac OS, it loses focus when the user
uses T to shift the focus, not when the
AB
user clicks outside the control.
N : When the user types E
OTE
containing dialog is invoked. In the case of an Export dialog section, this is the Export
button. If you do not want that to happen, disable the default button until the user
indicates that input is done.
Type-specific properties
title
value
checked_value
selected (checked) this becomes the
, and
control value. Default is true.
is
value
unchecked_value
. If its
value
deselected (unchecked) this becomes
the control value. Default is false.
All text properties. See
properties" on page
value
items
appear in the menu, or a function that
returns such an array. The values are
not localizable in place; to localize, you
value
, and is must build the array with localized
strings.
All edit and text properties. See
"Edit-field view properties" on page 92
and
All edit and text properties. See
"Edit-field view properties" on page 92
and
value
is false,
/R in an edit field, the default button of the
NTER ETURN
User interface elements 86
: Display label.
: The control value.
: When the box is
: When the box is
"Text view
94.
: The value, an
LrColor
: An array of entry values to
"Text view properties" on page
"Text view properties" on page
object.
94.
94.