Adobe 29180248 User Guide - Page 39

MXI tag descriptions

39

menuitem

Description

Describes the menu item to be inserted into the application’s menu structure during installation

of this extension.

Attributes

name

,

id

,

{key}

,

{platform}

,

{file}

,

{command}

,

{enabled}

,

{checked}

,

{dynamic}

,

{arguments}

, {

resid:name}

name

The menu item name that you want to appear in the menu. To set the menu item’s access

key on Windows, use an underscore (_) in front of the access letter. The underscore is

automatically removed on Mac OS. If two menu items have the same access key, the access key

works only for the first of the two.

Note:

To make an underscore character appear in a menu item, precede it with a percent sign—that is, use

%_

instead

of just an underscore.

id

The menu ID of the new item. Your menu IDs should start with a company name or some

other namespace prefix to ensure uniqueness. In particular, don’t start your menu IDs with

DW

,

which is the prefix used by the Dreamweaver menu IDs. One useful approach is to prefix every

ID with your domain name (with the elements reversed); for example, if your domain name is

joe.com, you could start every ID with

com.joe.

to ensure uniqueness.

key

The shortcut key for the menu item. For syntax details that apply to Dreamweaver, see

“About customizing Dreamweaver menus” in the “Customizing Dreamweaver” chapter of

Using

Dreamweaver

.

platform

Indicates that the menu should appear only on the given platform. Valid values are

"win"

and

"mac"

.

file

The name of an HTML or JavaScript file that contains JavaScript code determining the

behavior of the menu item. The path specified in the

file

attribute is relative to the

Configuration folder. The

file

attribute overrides the

command

,

enabled

, and

checked

attributes. Either

file

or

command

must be specified for each menu item. Note that in some

operating systems, filenames are case-sensitive; make sure to use the same capitalization in the

file

attribute as you use for the corresponding file and folder names on your hard disk.

command

JavaScript code specifying the action to be taken when the user chooses the

menu

item.

enabled

JavaScript code that the application executes before displaying the menu, to determine

whether the menu item is enabled. The code should return a value of

true

or

false

, indicating

that the menu item should be enabled or dimmed, respectively.

checked

JavaScript code that the application executes before displaying the menu, to determine

whether the menu item should have a check mark next to it. The code should return a value of

true

or

false

, indicating that the menu item should be checked or unchecked, respectively.

dynamic

Indicates whether the menu item’s text and state are to be determined dynamically, by

an HTML file that contains JavaScript code (specified in the

file

attribute). Valid values are

"true"

and

"false"

. If you don’t specify the

dynamic

attribute, its default value is

"false"

.

arguments

Provides arguments to pass to the specified command file. This attribute is used

only in conjunction with the

file

attribute.

Section	Page
Packaging Extensions with Extension Manager CS5	4
Choose the extension package format	5
Create the extension installation file	6
About careful XML coding	7
Encoding characters	7
MXI tag summary	7
MXI tag descriptions	9
macromedia-extension	10
defaultLanguage	12
description	13
update	14
license-agreement	14
ui-access	15
products	15
product	16
author	18
files	19
file	19
file-tokens	24
token	24
configuration-changes	25
documenttype-changes	26
documenttype-insert	26
documenttype-remove	27
toolpanel-changes	27
toolpanel-item-insert	28
ftp-extension-map-changes	28
ftp-extension-insert	29
ftp-extension-remove	29
insertbar-changes	30
insertbar-insert	30
insertbar-remove	31
insertbar-item-insert	32
insertbar-item-remove	32
server-behavior-changes	33
server-format-changes	33
server-format-definition-changes	34
data-source-changes	34
menu-insert	35
menu-remove	37
menubar	37
menu	38
menuitem	39
format	40
separator	41
comment	41
shortcut-insert	42
shortcut-remove	42
shortcutlist	43
shortcut	43
taglibrary-changes	44
taglibrary-insert	44
taglibrary-remove	45
toolbar-changes	45
toolbar-insert	46
toolbar-remove	46
toolbar-item-insert	47
toolbar-item-remove	48
extensions-changes	48
extension-insert	49
extension-remove	49
Tags and their compatible products	51
Example MXI file	53
Creating multilingual extension packages (version 2.1 and later)	54
Enabling multilingual support in an MXI file	54
Setting up the folder hierarchy for localized XML files	55
Formatting XML for language-specific strings	55
Installing localized files	55
Configuration changes	56
Creating a ZXP extension package (version 5.0 only)	56
Sign ZXP format extension	56
Validate ZXP format extension	57
Creating Hybrid Extension packages (version 5.0 only)	57
Use file-type attribute	57
Use default-file-type attribute	57
Creating plug-in extension packages for InDesign CS5 and InCopy CS5 (version 5.0 only)	58
Creating Enable_for_all_disable_for_one extension packages	58
Creating Enable_for_one_disable_for_one extension packages	58
Creating updatable extension packages (version 5.0 only)	59
Creating update information file	59
Checking update upon launch of Extension Manager	60
Use Extension Manager from the command line	60
Parameter definitions	60
Attribute definitions	60
Parameter formats	61
Command execution result	61
Headless mode	61
\	62
Return code(Extension Manager CS5 only)	62
Execute command through BridgeTalk	62
Examples:	62
Install extension through CLI	62
\	62
\	63
\	63
\	63
\	63
\	63
\	63
\	64
Invalid parameters	64
Valid irregular parameters (which support dragging or double-clicking to install and package)	64
Use Extension Manager from the graphical user interface (GUI)	65

Adobe 29180248 User Guide - Page 39

menuitem, Using, Dreamweaver

Page 39 highlights