Adobe 65007312 Programming Guide - Page 87

CHAPTER 5: Creating a User Interface for Your Plug-in User interface elements 87 Control type Description Type-specific properties password_field An editable text field that obscures the entered text, displaying only bullet characters. All edit and text properties. See "Edit-field view properties" on page 92 and "Text view properties" on page 94. picture A static image or icon. TIP: you can typically get the path to the image file using this function: _PLUGIN:resourceId('myPic.png') value: The full path to the JPG or PNG image file. frame_width: Pixel width of a frame to draw around the image. Default: 0. frame_color: An LrColor object. Default is black. popup_menu A pop-up menu of choices, each with a title and value. When the user pops up the menu and makes a choice, the selected item's title and value become those of the control. The current title text is displayed in the control when the menu is not open. See "Binding pop-up menu selections" on page 100 for example of how to specify items and use the value_equal function. title: Display label. value: The value of the currently selected item. items: A table of items to appear in the menu. Each selectable item entry contains a title and a value. The title text is displayed when the menu is open. An entry of separator=true creates a separator, an unselectable line in the menu. value_equal: A function that compares the current control value to each item's value in turn, to determine the selection. All text properties. See "Text view properties" on page 94. push_button A button that responds to a click with an action. Drawn in platform-standard style with a rounded appearance. title: Display label. action: A function defining the action to be taken when the button is clicked, in the form myAction( button ). All text properties. See "Text view properties" on page 94. radio_button Displays the title text with a platform-style radio button. The button is checked (selected) when its value is equal to its checked_value, and unchecked (deselected) when its value has any other value, except nil. When the value is nil, the button shows a mixed state. title: Display label. value: The control value. checked_value: A value that indicates the selected state. Within a container, only one of a set of radio buttons should be selected. Selecting one button should deselect all others in the set. You must enforce this in the way you bind the button values. It is not automatic. See "Binding radio button selections" on page 99.