AddButton

All Editions  image\bltlrgss.gif Related Transactions  image\bltlrgss.gif Example

The AddButton transaction adds the specified button to the specified button bar.

Type XTYP_EXECUTE

Syntax [AddButton(buttonBar, newCmdID, commandID, relPsn)]

Parameter

Data type

Values

Meaning

buttonBar

WORD

1

2

View Ribbon

Tool Bar

newCmdID

DWORD

1

Command IDs

 

4096 or more

insert separator. See Remarks.

identifier of the command to place in the button bar.

External command identifier. The command must be registered, and must have a button set for it.

commandID

DWORD

Command IDs

identifier of an existing command in the button bar relative to which the new command is placed. Used if relPsn equals 3 or 4.

relPsn

WORD

1

place button at the start of the bar

 

 

2

place button at the end of the bar

 

 

3

place button in front of the commandID command button

 

 

4

place button after the commandID command button

Remarks

Only commands available in your edition of Imagenation can be added.

Separators add a gap between buttons.

To see the changes, use the RebuildButtonBar transaction.

Release information

Added in Release 4.5.

See also

Defining button bars

Adding and removing buttons

Defining external commands