A collection of buttons.
Element
behavior
close window behavior
EPS
goto anchor behavior
goto first page behavior
goto last page behavior
goto next page behavior
goto next view behavior
goto previous page behavior
goto previous view behavior
goto URL behavior
graphic
graphic line
group
image
movie behavior
open file behavior
oval
page item
PDF
PICT
polygon
quit behavior
rectangle
show hide fields behavior
sound behavior
state
text frame
view zoom behavior
WMF
button Properties
| Property | Type | Access | Description |
|---|---|---|---|
| absolute flip | none, horizontal, vertical, horizontal and vertical, both, none, horizontal, vertical, horizontal and vertical, both, none, horizontal, vertical, horizontal and vertical, both, none, horizontal, vertical, horizontal and vertical, both, |
r/w | Indicates whether the button has been flipped independently of its parent object and, if yes, the direction in which the button was flipped. |
| absolute horizontal scale | fixed | r/w | The horizontal scale of the button relative to its containing object. |
| absolute rotation angle | fixed | r/w | The rotation angle of the button relative to its containing object. (Range: -360 to 360) |
| absolute shear angle | fixed | r/w | The skewing angle of the button relative to its containing object. (Range: -360 to 360) |
| absolute vertical scale | fixed | r/w | The vertical scale of the button relative to its containing object. |
| all graphics | List of graphic | read | Lists all graphics contained by the button. |
| all page items | List of page item | read | Lists all page items contained by the button. |
| allow overrides | boolean | r/w | If true, the master page button allows overrides. |
| anchored object settings | anchored object setting | read | Anchored object settings. |
| appearance name | string | read | The appearance applied to the button. |
| applied object style | object style | r/w | The object style applied to the button. |
| associated XML element | XML item | read | The XML element associated with the button. |
| class | type class | read | The class descriptor type. |
| content transparency settings | content transparency setting | read | Transparency settings for the content of the button. |
| corner option | none, rounded corner, inverse rounded corner, inset corner, bevel corner, fancy corner, none, rounded corner, inverse rounded corner, inset corner, bevel corner, fancy corner, none, rounded corner, inverse rounded corner, inset corner, bevel corner, fancy corner, none, rounded corner, inverse rounded corner, inset corner, bevel corner, fancy corner, none, rounded corner, inverse rounded corner, inset corner, bevel corner, fancy corner, |
r/w | The shape to apply to corner points in a path. Note: corner option differs from end join in that you can set a radius for a corner option, whereas the rounded or beveled effect of an end join depends upon the stroke weight. |
| corner radius | number or string | r/w | The radius in measurement units of the corner effect. |
| description | string | r/w | The description of the button. |
| end cap | butt end cap, round end cap, projecting end cap, butt end cap, round end cap, projecting end cap, butt end cap, round end cap, projecting end cap, butt end cap, round end cap, projecting end cap, butt end cap, round end cap, projecting end cap, butt end cap, round end cap, projecting end cap, |
r/w | The end shape of an open path. |
| end join | miter end join, round end join, bevel end join, miter end join, round end join, bevel end join, miter end join, round end join, bevel end join, miter end join, round end join, bevel end join, miter end join, round end join, bevel end join, miter end join, round end join, bevel end join, |
r/w | The corner join applied to the button. |
| fill color | swatch | r/w | The swatch (color, gradient, tint, or mixed ink) applied to the to fill the button. . Can also accept: string. |
| fill tint | fixed | r/w | The percent of tint to use in the button’s fill color. (To specify a tint percent, use a number in the range of 0 to 100; to use the inherited or overridden value, use -1.) |
| fill transparency settings | fill transparency setting | read | Transparency settings for the fill applied to the button. |
| flip | none, horizontal, vertical, horizontal and vertical, both, none, horizontal, vertical, horizontal and vertical, both, none, horizontal, vertical, horizontal and vertical, both, none, horizontal, vertical, horizontal and vertical, both, |
r/w | The direction in which to flip the printed image. |
| frame fitting options | frame fitting option | read | The frame fitting option to apply to placed or pasted content. Can be applied to a frame, object style, or document or to the application. |
| gap color | swatch | r/w | The swatch (color, gradient, tint, or mixed ink) applied to the gap of a dashed, dotted, or striped stroke. For information, see stroke type. |
| gap tint | fixed | r/w | The tint as a percentage of the gap color. (To specify a tint percent, use a number in the range of 0 to 100; to use the inherited or overridden value, use -1.) |
| geometric bounds | List of number or string | r/w | The bounds of the button excluding the stroke width, in the format [y1, x1, y2, x2], which give the coordinates of the top-left and bottom-right corners of the bounding box. |
| gradient fill angle | fixed | r/w | The angle of a linear gradient applied to the fill of the button. (Range: -180 to 180) |
| gradient fill length | number or string | r/w | The length (for a linear gradient) or radius (for a radial gradient) applied to the fill of the button. |
| gradient fill start | List of number or string | r/w | The starting point (in page coordinates) of a gradient applied to the fill of the button, in the format [x, y]. |
| gradient stroke angle | fixed | r/w | The angle of a linear gradient applied to the stroke of the button. (Range: -180 to 180) |
| gradient stroke length | number or string | r/w | The length (for a linear gradient) or radius (for a radial gradient) applied to the stroke of the button. |
| gradient stroke start | List of number or string | r/w | The starting point (in page coordinates) of a gradient applied to the stroke of the button, in the format [x, y]. |
| horizontal scale | fixed | r/w | The horizontal scaling applied to the text as a percentage of its current size. (Range: 1 to 1000) |
| id | integer | read | The unique ID of the button. |
| index | integer | read | The index of the button within its containing object. |
| item layer | layer | r/w | The layer that the button is on. |
| label | string | r/w | A property that can be set to any string. |
| left line end | none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, |
r/w | The arrowhead applied to the start of the path. |
| local display setting | high quality, typical, optimized, default, high quality, typical, optimized, default, high quality, typical, optimized, default, |
r/w | Display performance options for the button. |
| lock state | none, unmanaged story, checked in story, checked out story, locked story, embedded story, missing lock state, mixed lock state, none, unmanaged story, checked in story, checked out story, locked story, embedded story, missing lock state, mixed lock state, none, unmanaged story, checked in story, checked out story, locked story, embedded story, missing lock state, mixed lock state, none, unmanaged story, checked in story, checked out story, locked story, embedded story, missing lock state, mixed lock state, |
read | The lock state. |
| locked | boolean | r/w | If true, the button is locked. |
| miter limit | fixed | r/w | The limit of the ratio of stroke width to miter length before a miter (pointed) join becomes a bevel (squared-off) join. (Range: 1 to 500) |
| name | string | r/w | The name of the button. |
| nonprinting | boolean | r/w | If true, the button does not print. |
| object reference | button | read | An object reference for the button. |
| overprint fill | boolean | r/w | If true, the button’s fill color overprints any underlying objects. If false, the fill color knocks out the underlying colors. |
| overprint gap | boolean | r/w | If true, the gap color overprints any underlying colors. If false, the gap color knocks out the underlying colors. |
| overprint stroke | boolean | r/w | If true, the button’s stroke color overprints any underlying objects. If false, the stroke color knocks out the underlying colors. |
| overridden | boolean | read | If true, the object originated on a master spread and was overridden. If false, the object either originated on a master spread and was not overridden, or the object did not originate on a master page. |
| overridden master page item | reference | read | An object that originated on a master page and has been overridden. Can return: page item, guide, graphic, movie or sound. |
| parent | reference | read | The parent of the button (a spread, master spread, group, text frame, story, text, character, word, line, text column, paragraph, text style range, cell, table, page, document, layer or insertion point). Can return: spread, master spread, group, text f… |
| properties | record | r/w | A property that allows setting of several properties at the same time. |
| right line end | none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, none, simple arrow head, simple wide arrow head, triangle arrow head, triangle wide arrow head, barbed arrow head, curved arrow head, circle arrow head, circle solid arrow head, square arrow head, square solid arrow head, bar arrow head, |
r/w | The arrowhead applied to the end of the path. |
| rotation angle | fixed | r/w | The rotatation angle of the button. (Range: -360 to 360) |
| shear angle | fixed | r/w | The skewing angle applied to the button. (Range: -360 to 360) |
| stroke alignment | center alignment, inside alignment, outside alignment, center alignment, inside alignment, outside alignment, center alignment, inside alignment, outside alignment, center alignment, inside alignment, outside alignment, center alignment, inside alignment, outside alignment, |
r/w | The stroke alignment applied to the button. |
| stroke color | swatch | r/w | The swatch (color, gradient, tint, or mixed ink) applied to the to stroke of the button. Can also accept: string. |
| stroke corner adjustment | none, dashes, gaps, dashes and gaps, none, dashes, gaps, dashes and gaps, none, dashes, gaps, dashes and gaps, none, dashes, gaps, dashes and gaps, none, dashes, gaps, dashes and gaps, none, dashes, gaps, dashes and gaps, |
r/w | The corner adjustment applied to the button. |
| stroke dash and gap | List of number or string | r/w | The dash and gap measurements that define the pattern of a custom dashed line. Define up to six values (in points) in the format [dash1, gap1, dash2, gap2, dash3, gap3]. |
| stroke tint | fixed | r/w | The percent of tint to use in object’s stroke color. (To specify a tint percent, use a number in the range of 0 to 100; to use the inherited or overridden value, use -1.) |
| stroke transparency settings | stroke transparency setting | read | Transparency settings for the stroke. |
| stroke type | stroke style | r/w | The name of the stroke style to apply. Can also accept: string. |
| stroke weight | number or string | r/w | The weight (in points) to apply to the button’s stroke. |
| text wrap preferences | text wrap preference | read | The text wrap preference properties that define the default formatting for wrapping text around objects. |
| transparency settings | transparency setting | read | Transparency settings. |
| vertical scale | fixed | r/w | The vertical scaling applied to the text as a percentage of its current size. (Range: 1 to 1000) |
| visibility in pdf | visible in pdf, hidden in pdf, visible but does not print in pdf, hidden but printable in pdf, |
r/w | The field’s visibility in the PDF document. |
| visible bounds | List of number or string | r/w | The bounds of the button including the stroke width, in the format [y1, x1, y2, x2], which give the coordinates of the top-left and bottom-right corners of the bounding box. |