IUIX_CmdMenu::InsertItem3 Method

UI Layer > Interfaces > IUIX_CmdMenu > IUIX_CmdMenu::InsertItem3 Method

Inserts new command menu item with given item ID, data, and style.

Syntax

HRESULT InsertItem3([in]                               BSTR              sItemID,
                    [in]                               BSTR              sText,
                    [in]                               IUIX_CmdHandler*  pCmdHandler,
                    [in, defaultvalue(0)]              LONG              nTargetID,
                    [in, defaultvalue(NULL)]           IUIX_Icon*        pIcon,
                    [in, defaultvalue("")]             BSTR              sTip,
                    [in, defaultvalue(-1)]             LONG              nIndexBefore,
                    [in, defaultvalue(0)]              LONG              nStyle,
                    [out, retval, defaultvalue(NULL)]  IUIX_CmdMenu**    pItem);

Parameters

sItemID

[in] Value of BSTR containing the item ID.

sText

[in] Value of BSTR containing the text that will be displayed as a command menu item's label.

pCmdHandler

[in] Pointer to IUIX_CmdHandler containing the command handler.

nTargetID

[in, defaultvalue(0)] Value of LONG containing command's target ID.

pIcon

[in, defaultvalue(NULL)] Pointer to IUIX_Icon containing the command's icon.

sTip

[in, defaultvalue("")] Value of BSTR containing the command's tooltip.

nIndexBefore

[in, defaultvalue(-1)] Value of LONG containing the command insertion index.

nStyle

[in, defaultvalue(0)] Value of LONG containing the command style flags.

pItem

[out, retval, defaultvalue(NULL)] Pointer to IUIX_CmdMenu containing the resulting command menu item.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IUIX_CmdMenu