MM SETITEMTEXT

This message sets the text of a menu item.

Syntax

param1
    USHORT usitem;      /* Item identifier. */

param2
    PSZ    pszItemText; /* Item text. */

Parameters

usitem (USHORT) - input

Item identifier.

pszItemText (PSZ) - input

Points to a string containing the text to set the menu item to.

Returns

rc (BOOL) - returns

Success indicator.

TRUE: Successful completion

FALSE: Error occurred

Remarks

The menu control responds to this message by setting the text of the identified item, if it has a style of MIS_TEXT, using the specified null-terminated string. To right-align text in a menu item, you must embed an ASCII 8 (0x08) character preceding it.

Note: This message must be sent, not posted, to the menu control.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it, other than to set rc to the default value of FALSE.