Adding Custom Sections To The Plug-In Manager - Adobe 65007312 - Photoshop Lightroom Programmer's Manual

C 2: Writing a Lightroom Plug-in
HAPTER
selected in the Export dialog, never from the Plug-in Manager dialog. See
functions for services" on page
The propertyTable parameter for both functions is an empty, observable table which you can use to keep
private data for your plug-in. (See
when your plug-in is deselected in the Plug-in Manager or when the Plug-in Manager dialog is closed. It is
not preserved across sessions. You can use
invocations.
These are blocking calls. If you need to start a long-running task (such as network access), create a task
using the

Adding custom sections to the Plug-in Manager

Your plug-in can define one or more sections to be displayed in the Plug-in Manager dialog (when defined
in an
LrPluginInfoProvider
LrExportServiceProvider
standard sections for the dialog.
To customize the dialog, define a function that returns a table of sections, defined using
The function is the value of one of these service entries:
sectionsForTopOfDialog = function( viewFactory, propertyTable ) ... end,
sectionsForBottomOfDialog = function( viewFactory, propertyTable ) ... end,
N
OTE
when the export destination is selected or the Publishing Manager dialog for a publish service, and
also in an Export Filter Provider, to add a section to the dialog when a post-process action is selected.
See "Customizing the Export and Publishing Manager dialogs" on page 52
post-process action" on page
Lightroom passes your function a factory object which allows you to create the
the elements of your sections; that is, UI controls, such as buttons and text, and containers that group the
controls and determine the layout. For additional details of the dialog elements you can create with
, see
LrView
The function that you define here returns a table of tables, where each table defines one dialog section:
sectionsForTopOfDialog = function( viewFactory, propertyTable )
return {
}
end
A section entry table defines the contents of an implicit container, which Lightroom creates to hold your
view hierarchy.
Each section entry sets a
text on the left, and is collapsible. When in the collapsed state, the
right.
The rest of the table entry creates the UI elements that are shown when the section is expanded. To
create the UI elements, use the
This process is explained in more detail in
38.
namespace. See
LrTasks
entry) or in the Export or Publishing Manager dialog (when defined in an
entry). The custom sections can be shown above or below the Lightroom
: Similar functions can be defined in an Export Service Provider, to customize the Export dialog
"Adding custom dialog views" on page
{ ...section entry ... },
{ ...section entry ... },
...
}
title
"Binding UI values to data values" on page
LrPreferences
"Defining function contexts and tasks" on page
41.
82. "
and for the section; the section is identified by the
synopsis
factory passed to your top-level
LrView
"Adding custom dialog views" on page
Customizing plug-in load behavior 32
"Initialization and termination
94.) This table is discarded
if you want to save information across
and
LrView
text is shown on the
synopsis
sectionsFor...
20.
objects.
LrView
"Adding an export
objects that define
title
function.
82.