Поделиться через

IAgentCommandsEx::InsertEx

  • Статья

[Microsoft Agent является нерекомендуемым начиная с Windows 7 и может быть недоступен в последующих версиях 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
);

Вставляет объект Command в коллекцию Commands .

  • Возвращает S_OK, указывающее, что операция была успешной.

bszCaption

Строка BSTR, указывающая значение текста заголовка , отображаемого для команды.

bszVoice

Строка BSTR, указывающая значение параметра Голосовой текст для команды.

bszVoiceCaption

Объект BSTR, указывающий значение текста VoiceCaption , отображаемого для command в коллекции Commands .

bEnabled

Логическое выражение, указывающее параметр Enabled для команды. Если параметр имеет значение True, команда включена и может быть выбрана; Значение False, команда отключена.

bVisible

Логическое выражение, указывающее параметр Visible для команды. Если параметр имеет значение True, команда будет отображаться во всплывающем меню символа (если также задано свойство Caption ).

ulHelpID

Номер контекста раздела справки, связанного с объектом Command ; используется для предоставления контекстно-зависимых справки по команде.

dwRefID

Идентификатор команды , используемой в качестве ссылки для относительной вставки новой команды.

dBefore

Логическое выражение, указывающее место размещения команды. Если этот параметр имеет значение True, новая команда вставляется перед указанной командой; Значение False, новая команда помещается после указанной команды.

pdwID

Адрес переменной, которая получает идентификатор вставленной команды.

IAgentCommandsEx::InsertEx расширяет IAgentCommands::Insert , включив свойство HelpContextID . Свойство можно также задать с помощью IAgentCommandsEx::SetHelpContextID.

См. также:

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