|
AIMenu.h File Reference#include "AITypes.h"
#include "AIPlugin.h"
#include "ASHelp.h"
#include "IAIUnicodeString.h"
#include "AIHeaderBegin.h"
#include "AIHeaderEnd.h"
Go to the source code of this file.
Classes |
struct | AIPlatformAddMenuItemDataUS |
| Menu item definition data. More...
|
struct | AIPlatformMenuItem |
| A platform-specific menu structure corresponding to an Illustrator menu item. More...
|
struct | AIMenuMessage |
| Message sent with menu selectors. More...
|
struct | AIMenuSuite |
| This suite provides functions that allow you to add menu items to the Illustrator menu structure. More...
|
Defines |
#define | kAIMenuSuite "AI Menu Suite" |
#define | kAIMenuVersion11 AIAPI_VERSION(11) |
#define | kAIMenuSuiteVersion kAIMenuVersion11 |
#define | kAIMenuVersion kAIMenuSuiteVersion |
#define | kAIMenuChangedNotifier "AI Menu Changed Notifier" |
| Sent when a menu item is modified using AIMenuSuite functions.
|
#define | kCallerAIMenu "AI Menu" |
| Menu caller, see AIMenuSuite .
|
#define | kSelectorAIGoMenuItem "AI Go" |
| Sent to the plug-in that installed a menu item when the item is selected by the user.
|
#define | kSelectorAIUpdateMenuItem "AI Update" |
| Sent on mouse down in the menu bar.
|
#define | kMacIfPlugin kIfPluginArt |
| For pre-AI14 compatibility.
|
#define | kTooManyMenuItemsErr '>MIT' |
Typedefs |
typedef ai::int32 | AIMenuItemOption |
| Option flags that control the behavior of a menu item.
|
typedef ai::int32 | AIMenuGroupOption |
| Option flags that control the behavior of a menu group.
|
typedef struct
_t_AIMenuItemOpaque * | AIMenuItemHandle |
| Opaque reference to a menu item.
|
typedef struct _t_MenuGroupOpaque * | AIMenuGroup |
| Opaque reference to a menu group.
|
Enumerations |
enum | {
kMenuItemNoOptions = 0,
kMenuItemWantsUpdateOption = (1<<0),
kMenuItemAlwaysEnabled = (1<<1),
kMenuItemIsSeparator = (1<<2),
kMenuItemIsGroupHeader = (1<<3),
kMenuItemIgnoreSort = (1<<4)
} |
| Bit flags for AIMenuItemOption .
More...
|
enum | {
kMenuGroupNoOptions = 0,
kMenuGroupSortedAlphabeticallyOption = (1<<0),
kMenuGroupSeparatorOption = (1<<1),
kMenuGroupSeparatorBelowOption = (1<<2),
kMenuGroupHasHeader = (1<<3),
kMenuGroupAddAboveNearGroup = (1<<4)
} |
| Bit flags for AIMenuGroupOption .
More...
|
enum | AIAutoMenuUpdateAction { kAutoEnableMenuItemAction = (1<<0),
kAutoCheckMenuItemAction = (1<<1)
} |
| The update action to be performed when all criteria are met.
More...
|
enum | AIAutoMenuUpdateObjectCriteria {
kIfGroup = (1<<0),
kIfPath = (1<<1),
kIfPostscript = (1<<2),
kIfPlaced = (1<<3),
kIfText = (1<<4),
kIfTextPath = (1<<5),
kIfTextFlow = (1<<6),
kIfTextRun = (1<<7),
kIfGuide = (1<<8),
kIfGraphData = (1<<9),
kIfMask = (1<<10),
kIfEndMask = (1<<11),
kIfNormalGroup = (1<<12),
kIfCompoundGroup = (1<<13),
kIfWrapAroundGroup = (1<<14),
kIfClipGroup = (1<<15),
kIfPointText = (1<<16),
kIfInPathText = (1<<17),
kIfOnPathText = (1<<18),
kIfThreadedText = (1<<19),
kIfRaster = (1<<20),
kIfPluginArt = (1<<21),
kIfMesh = (1<<22),
kIfHasStyledArt = (1<<23),
kIfSymbol = (1<<24),
kIfForeignArt = (1<<25),
kIfLegacyTextArt = (1<<26),
kIfClassicPath = (1<<27),
kIfPlanarPath = (1<<28),
kIfNonTextPath = (1<<29),
kIfChartArt = (1<<30),
kIfAnyArt = (0xFFFFFFFF)
} |
| Types of art objects whose appearance in a document or selection can be considered for automatic menu update.
More...
|
enum | AIAutoMenuUpdatePropertyCriteria {
kIfCurrentLayerIsEditable = (1<<0),
kIfOpenTextEdit = (1<<1),
kIfAnyPrintingChars = (1<<2),
kIfAnyHiddenObjects = (1<<3),
kIfAnyLockedObjects = (1<<4),
kIfAnyClipPaths = (1<<5),
kIfOpenDocument = (1<<6),
kIfCMYKDocument = (1<<7),
kIfRGBDocument = (1<<8),
kIfCurrentArtStyleIsNamed = (1<<9),
kIfHasPluginSelection = (1<<10)
} |
| Document properties that can be considered for automatic menu update.
More...
|
enum | AIMenuItemModifier { kMenuItemCmdShiftModifier = 1,
kMenuItemCmdOptionModifier = 2,
kMenuItemCmdControlModifier = 4
} |
| Modifier keys for command characters (keyboard shortcuts).
More...
|
Detailed Description
Define Documentation
#define kAIMenuSuite "AI Menu Suite" |
#define kAIMenuSuiteVersion kAIMenuVersion11 |
#define kAIMenuVersion kAIMenuSuiteVersion |
#define kAIMenuVersion11 AIAPI_VERSION(11) |
#define kMacIfPlugin kIfPluginArt |
For pre-AI14 compatibility.
Typedef Documentation
Opaque reference to a menu group.
Never dereferenced. Access with AIMenuSuite functions.
Opaque reference to a menu item.
Never dereferenced. Access with AIMenuSuite functions.
Option flags that control the behavior of a menu item.
See kMenuItemNoOptions and following.
Enumeration Type Documentation
Bit flags for AIMenuGroupOption .
- Enumerator:
kMenuGroupNoOptions |
Turn off all options.
|
kMenuGroupSortedAlphabeticallyOption |
Set to sort menu items in the group alphabetically.
By default, menu items appear in the order in which they are added.
|
kMenuGroupSeparatorOption |
Set to create a separator above the group.
|
kMenuGroupSeparatorBelowOption |
Set to create a separator below the group.
|
kMenuGroupHasHeader |
Not for group creation.
Identifies a group with a header when iterating through groups. See AIMenuSuite::SetMenuGroupHeader() .
|
kMenuGroupAddAboveNearGroup |
Option for adding a group with AIMenuSuite::AddMenuGroup() .
|
The update action to be performed when all criteria are met.
Specify only one action. See AIMenuSuite::UpdateMenuItemAutomatically() .
- Enumerator:
kAutoEnableMenuItemAction |
Enables the item if the criteria evaluate to true, disables it otherwise.
|
kAutoCheckMenuItemAction |
Puts a check mark by the item if the criteria evaluate to true, removes the check otherwise.
|
Types of art objects whose appearance in a document or selection can be considered for automatic menu update.
See AIMenuSuite::UpdateMenuItemAutomatically() .
- Enumerator:
kIfGroup |
Any type of group.
|
kIfPath |
Any type of path.
|
kIfPostscript |
An internal object type unavailable to users and plug-ins.
|
kIfPlaced |
A placed object.
|
kIfText |
Any type of text.
|
kIfTextPath |
A path that has text in or on it.
Can be set even if kIfText is off, when a text path is direct-selected.
|
kIfTextFlow |
Obsolete.
|
kIfTextRun |
Obsolete.
|
kIfGuide |
Art used as a guide.
|
kIfGraphData |
A graph object.
|
kIfMask |
Art used as a clipping mask.
|
kIfEndMask |
Obsolete.
|
kIfNormalGroup |
A simple group.
|
kIfCompoundGroup |
A group that is a compound path.
|
kIfWrapAroundGroup |
Obsolete.
Do not use.
|
kIfClipGroup |
A group with a clipping path.
|
kIfPointText |
Point text.
|
kIfInPathText |
Text in a path.
|
kIfOnPathText |
Text on a path.
|
kIfThreadedText |
Threaded text.
|
kIfRaster |
Raster art.
|
kIfPluginArt |
Plug-in group (for any platform).
|
kIfMesh |
Mesh art.
|
kIfHasStyledArt |
Styled art.
|
kIfSymbol |
Symbol.
|
kIfForeignArt |
Foreign object.
|
kIfLegacyTextArt |
Legacy text.
|
kIfClassicPath |
Path that is not inside a planar group.
|
kIfPlanarPath |
Path that is inside a planar group.
See AIPlanarObjectSuite .
|
kIfNonTextPath |
A path that does not have text in or on it.
|
kIfChartArt |
Chart.
|
kIfAnyArt |
Any art.
|
Document properties that can be considered for automatic menu update.
See AIMenuSuite::UpdateMenuItemAutomatically() .
- Enumerator:
kIfCurrentLayerIsEditable |
|
kIfOpenTextEdit |
|
kIfAnyPrintingChars |
|
kIfAnyHiddenObjects |
|
kIfAnyLockedObjects |
|
kIfAnyClipPaths |
|
kIfOpenDocument |
|
kIfCMYKDocument |
|
kIfRGBDocument |
|
kIfCurrentArtStyleIsNamed |
|
kIfHasPluginSelection |
|
Modifier keys for command characters (keyboard shortcuts).
See AIMenuSuite::SetItemCmd() and AIMenuSuite::GetItemCmd() .
- Enumerator:
kMenuItemCmdShiftModifier |
Shift key.
|
kMenuItemCmdOptionModifier |
Option key in Mac OS, Alt key in Windows.
|
kMenuItemCmdControlModifier |
Command key in Mac OS, Ctrl key in Windows.
|
|