Compartir a través de


IAgentCommandsEx::InsertEx

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows.

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

Inserta un objeto Command en una colección Commands .

  • Devuelve S_OK para indicar que la operación se realizó correctamente.

bszCaption

Un BSTR que especifica el valor del texto caption que se muestra para el comando.

bszVoice

Un BSTR que especifica el valor de la configuración de texto voz de un comando.

bszVoiceCaption

Un BSTR que especifica el valor del texto VoiceCaption que se muestra para un objeto Command en una colección Commands .

bEnabled

Expresión booleana que especifica el valor Habilitado para un comando. Si el parámetro es True, el comando está habilitado y se puede seleccionar; Si es False, el comando está deshabilitado.

bVisible

Expresión booleana que especifica el valor Visible de un comando. Si el parámetro es True, el comando estará visible en el menú emergente del carácter (si también se establece la propiedad Caption ).

ulHelpID

Número de contexto del tema de ayuda asociado al objeto Command ; se usa para proporcionar ayuda contextual para el comando.

dwRefID

Identificador de un comando usado como referencia para la inserción relativa del nuevo comando.

dBefore

Expresión booleana que especifica dónde colocar el comando. Si este parámetro es True, el nuevo comando se inserta antes del comando al que se hace referencia; si es False, el nuevo comando se coloca después del comando al que se hace referencia.

pdwID

Dirección de una variable que recibe el identificador del comando insertado.

IAgentCommandsEx::InsertEx extiende IAgentCommands::Insert incluyendo la propiedad HelpContextID . También puede establecer la propiedad mediante IAgentCommandsEx::SetHelpContextID.

Consulte también

IAgentCommandsEx::AddEx, IAgentCommandsEx::SetHelpContextID, IAgentCommands::Add, IAgentCommands::Remove, IAgentCommands::RemoveAll