Using Dialog Boxes; Displaying Predefined Dialog Boxes - Adobe 65007312 - Photoshop Lightroom Programmer's Manual

C 5: Creating a User Interface for Your Plug-in
HAPTER
To create the containment hierarchy, use the view factory to create a container, and within that call, use it
to create the child containers and controls:
viewFactory:group_box {
...initial property settings...
viewFactory:row {-- a row of controls within the box
...initial property settings...
viewFactory:static_text { -- a text label, contained in the row
viewFactory:button { -- a button that responds to a click, contained in the row
...
Control nodes have properties that define a tooltip for the node, control the visibility, and affect the size,
displayed font, and enabled state. Additional properties apply to controls of specific types; for instance, a
pop-up menu has an
item is in turn a table containing a
selected):
viewFactory:popup_menu {
title = "myPopup",
items = { -- the menu items
{ title = "First item",
{ title = "Second item", value = 2 },
},
value = LrView.bind( "myPopup_value" ), -- the control value
size = 'small'
},
The types of containers and controls and their view properties are listed and described in
interface elements" on page
Certain properties describe node layout; that is, the sizing and placement of each node with respect to
its container and sibling nodes. You can set layout values individually, or use
spacing and margin values for an entire node tree. The layout properties and functions are described
in "Determining layout" on page
Display strings in all containers and controls (generally specified in the
localized to different languages by using the
Chapter 7, "Using ZStrings for

Using dialog boxes

The
LrDialogs
dialog boxes, or to define a completely customized dialog box. All dialog boxes are modal, meaning that
when the dialog is invoked, no other actions can be taken in the Lightroom UI until the dialog is dismissed.

Displaying predefined dialog boxes

The predefined dialog boxes display:
Messages
Message dialogs display your text message to the user. They have a single OK button that dismisses
the dialog; you can specify the button text. One version has a "Don't show again" checkbox, so that the
user can prevent this message from being displayed next time the same situation occurs.
...initial property settings...
...initial property settings...
property, which contains a table of the selectable menu items to display. Each
items
title
84.
Localization. "
namespace provides functions that you can use to display simple messages in predefined
(displayed string) and
value = 1 },
107.
function to specify the string value; for details, see
LOC
Using dialog boxes 83
(the value returned when the item is
value
LrView
property) can be
title
"User
functions to set