SetItemStyle

Select character formatting for a menu item

#include <Menus.h> Menu Manager

void SetItemStyle(theMenu, whichItem, chStyle );

MenuHandle theMenu ; handle of menu containing item to change

short whichItem ; item ID if an item in theMenu

Style chStyle ; character-formatting style bit flags

This changes the stylistic variation (bold, italic, underline, etc.) used when

a specified menu item is displayed. It allows options not supported by the ' <'

meta character.

theMenu is a handle leading to a variable-length MenuInfo structure. It

identifies the menu containing the item whose character style you

wish to change.

whichItem identifies which item in theMenu to query. Items are numbered

sequentially with the topmost item having an ID of 1.

chStyle is a set of bit codes specifying one or more styles. A value of 0

indicates "plain text" (in the 12-pt System font). The following

named constants are defined in Quickdraw.h:

Constant Dec Hex In Text Sample

bold 1 0x01 "\p

italic 2 0x02 "\p

outline 8 0x08 "\p

shadow 16 0x10 "\p

condense 32 0x20 (none) Êless space between characters

extend 64 0x40 (none) Ámore spaced out

Notes: By default, all items are assumed to be displayed in plain text (no stylistic

variations), unless you used the ’<' metacharacter when you defined the

The standard menu definition routine always uses the System font (12-pt

Chicago) for all menu titles and items. You can be more flexible by creating

your own menu definition procedure (see Custom Menus).

The common use for character styles in a menu is to display individual

style options with check marks to indicate the current value (see

CheckItem). It is also possible to use style to add emphasis. Also, there

is no rule against using more than one style for an item; e.g.:

SetItemStyle( theMenu, 4, (bold | underline) );

You can also define items with multiple style meta characters:

InsMenuItem( theMenu, 4, "\pBold+UL

Referenced by (17):