Adobe 65007312 Programming Guide - Page 91

General view properties, When true in a container, the container is visible,

Page 91 highlights

CHAPTER 5: Creating a User Interface for Your Plug-in User interface elements 91 General view properties Of the properties that are available in both containers and controls, many are connected with layout behavior; these are discussed separately in "Determining layout" on page 107. The following view properties are available in all containers and controls except the layout containers, row and column: View property bind_to_object -or- object tooltip visible Datatype Description table The default bound property table for this object and its children. The default can be overridden at any level of the node hierarchy, or for individual property bindings. See "Binding UI values to data values" on page 94. In views created with sectionsForTopOfDialog and sectionsForBottomOfDialog, this is set automatically to the property table passed along with the view factory. This creates a binding between all nodes in the view and the settings table, so that any node can observe any setting. string A help string that appears when the cursor hovers over a container or control. Default nil. Boolean Determines whether a container or control is shown or hidden. This is not the same as being enabled or disabled; the disabled state is only applied when a control is visible. Default is true. X When true in a container, the container is visible, and its children are visible according to their individual visibility values. X When false in a container, the container and all of its child nodes are hidden, regardless of the value in each child node. X When true in a control, the control is visible if its parent is visible. When false, it is hidden even if its parent is visible. Value must be true or false; do not use nil. TIP: An item still affects layout, even when it is hidden.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204

C
HAPTER
5: Creating a User Interface for Your Plug-in
User interface elements
91
General view properties
Of the properties that are available in both containers and controls, many are connected with layout
behavior; these are discussed separately in
“Determining layout” on page 107
. The following view
properties are available in all containers and controls except the layout containers,
row
and
column
:
View property
Datatype
Description
bind_to_object
—or—
object
table
The default bound property table for this object and its
children. The default can be overridden at any level of the
node hierarchy, or for individual property bindings. See
“Binding UI values to data values” on page 94
.
In views created with
sectionsForTopOfDialog
and
sectionsForBottomOfDialog
, this is set automatically to
the property table passed along with the view factory. This
creates a binding between all nodes in the view and the
settings table, so that any node can observe any setting.
tooltip
string
A help string that appears when the cursor hovers over a
container or control.
Default nil.
visible
Boolean
Determines whether a container or control is shown or
hidden. This is not the same as being enabled or disabled;
the disabled state is only applied when a control is visible.
Default is true.
X
When true in a container, the container is visible, and
its children are visible according to their individual
visibility values.
X
When false in a container, the container and all of its
child nodes are hidden, regardless of the value in each
child node.
X
When true in a control, the control is visible if its
parent is visible. When false, it is hidden even if its
parent is visible.
Value must be
true
or
false
; do not use
nil
.
T
IP
:
An item still affects layout, even when it is hidden.