IAgentCommandsEx::InsertEx

[Microsoft 에이전트는 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
);

Commands 컬렉션에 Command 개체를 삽입합니다.

• 작업이 성공했음을 나타내는 S_OK 반환합니다.

bszCaption

명령에 대해 표시되는 캡션 텍스트의 값을 지정하는 BSTR입니다.

bszVoice

명령의 음성 텍스트 설정 값을 지정하는 BSTR입니다.

bszVoiceCaption

Commands 컬렉션에서 Command에 대해 표시되는 VoiceCaption 텍스트의 값을 지정하는 BSTR입니다.

bEnabled

명령에 대해 사용 설정을 지정하는 부울 식입니다. 매개 변수가 True이면 명령 이 활성화되고 선택할 수 있습니다. False이면 명령을 사용할 수 없습니다.

bVisible

명령에 대한 표시 설정을 지정하는 부울 식입니다. 매개 변수가 True이면 명령 이 문자의 팝업 메뉴에 표시됩니다( Caption 속성도 설정된 경우).

ulHelpID

Command 개체와 연결된 도움말 항목의 컨텍스트 번호입니다. 는 명령에 대한 컨텍스트 구분 도움말을 제공하는 데 사용됩니다.

dwRefID

새 명령 의 상대 삽입에 대한 참조로 사용되는 명령의 ID입니다.

dBefore

명령을 배치할 위치를 지정하는 부울 식입니다. 이 매개 변수가 True이면 참조된 명령 앞에 새 명령이 삽입됩니다. False이면 참조된 명령 다음에 새 명령이 배치됩니다.

pdwID

삽입된 명령의 ID를 받는 변수의 주소입니다.

IAgentCommandsEx::InsertEx는 HelpContextID 속성을 포함하여 IAgentCommands::Insert를 확장합니다. IAgentCommandsEx::SetHelpContextID를 사용하여 속성을 설정할 수도 있습니다.

참고 항목

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