Platform SDK: Agent

IAgentCommands::Insert

HRESULT Insert(
   BSTR bszCaption,  // Caption setting for Command
   BSTR bszVoice,    // Voice setting for Command
   long bEnabled,    // Enabled setting for Command
   long bVisible,    // Visible setting for Command
   long dwRefID,     // reference Command for insertion
   long dBefore,     // insertion position flag
   long * pdwID      // address for variable for Command ID
);

Inserts a Command object in a Commands collection.

bszCaption
A BSTR that specifies the value of the Caption text displayed for the Command.
bszVoice
A BSTR that specifies the value of the Voice text setting for a Command.
bEnabled
A Boolean expression that specifies the Enabled setting for a Command. If the parameter is True, the Command is enabled and can be selected; if False, the Command is disabled.
bVisible
A Boolean expression that specifies the Visible setting for a Command. If the parameter is True, the Command will be visible in the character's pop-up menu (if the Caption property is also set).
dwRefID
The ID of a Command used as a reference for the relative insertion of the new Command.
dBefore
A Boolean expression that specifies where to place the Command. If this parameter is True, the new Command is inserted before the referenced Command; if False, the new Command is placed after the referenced Command.
pdwID
Address of a variable that receives the ID for the inserted Command.

See Also

IAgentCommands::Add, IAgentCommands::Remove, IAgentCommands::RemoveAll