[Microsoft 에이전트는 Windows 7을 기준으로 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]
Command 개체는 Commands 컬렉션의 항목입니다. 서버는 클라이언트 애플리케이션이 입력 활성 상태가 되는 명령에 대한 사용자 액세스를 제공합니다. 명령검색하려면 IAgentCommands::GetCommand호출합니다.
IAgentCommand 애플리케이션에서 문자의 팝업 메뉴와 음성 명령 창에 나타날 수 있는 명령 개체에 대한 속성을 설정하고 쿼리할 수 있는 인터페이스를 정의합니다. 이러한 함수는 IAgentCommandEx사용할 수도 있습니다. Command 개체는 Commands 컬렉션의 항목입니다. 서버는 클라이언트 애플리케이션이 입력 활성 상태가 될 때 명령에 대한 사용자 액세스를 제공합니다.
명령 문자의 팝업 메뉴와 음성 명령 창 둘 다에 나타날 수 있습니다. 팝업 메뉴에 표시하려면 캡션 있어야 하며 Visible 속성이 True설정해야 합니다. Commands 컬렉션 개체에 대한 Visible 속성도 클라이언트 애플리케이션이 입력 활성 상태일 때 팝업 메뉴에 표시되도록 True 설정해야 합니다. 음성 명령 창에 표시하려면 명령VoiceCaption 및 Voice 속성이 설정되어 있어야 합니다. 이전 버전과의 호환성을 위해 VoiceCaption 없는 경우 캡션 설정이 사용됩니다.
메뉴가 표시되는 동안에는 문자의 팝업 메뉴 항목이 변경되지 않습니다. 캐릭터의 팝업 메뉴가 표시되는 동안 명령을 추가하거나 제거하거나 해당 속성을 변경하면 다시 표시될 때 메뉴에 변경 내용이 표시됩니다. 그러나 음성 명령 창에는 변경 내용을 표시합니다.
다음 표에서는 명령의 속성이 프레젠테이션에 미치는 영향을 요약합니다.
| Caption 속성 | Voice-Caption 속성 | Voice 속성 | Visible 속성 | 문자의 팝업 메뉴에 표시 | 음성 명령 창에 표시 |
|---|---|---|---|---|---|
| 예 | 예 | 예 | 참 | 예, 캡션 사용 | 예, VoiceCaption 사용 |
| 예 | 예 | No 을(를) | 참 | 예, 캡션 사용 | 아니요 |
| 예 | 예 | 예 | False | 아니요 | 예, VoiceCaption 사용 |
| 예 | 예 | No 을(를) | False | 아니요 | 아니요 |
| No 을(를) | 예 | 예 | 참 | 아니요 | 예, VoiceCaption 사용 |
| No 을(를) | 예 | 예 | False | 아니요 | 예, VoiceCaption 사용 |
| No 을(를) | 예 | No 을(를) | 참 | 아니요 | 아니요 |
| No 을(를) | 예 | No 을(를) | False | 아니요 | 아니요 |
| 예 | No 을(를) | 예 | 참 | 예, 캡션 사용 | 예, 캡션 사용 |
| 예 | No 을(를) | No 을(를) | 참 | 예 | 아니요 |
| 예 | No 을(를) | 예 | False | 아니요 | 예, 캡션 사용 |
| 예 | No 을(를) | No 을(를) | False | 아니요 | 아니요 |
| No 을(를) | No 을(를) | 예 | 참 | 아니요 | No² |
| No 을(를) | No 을(를) | 예 | False | 아니요 | No² |
| No 을(를) | No 을(를) | No 을(를) | 참 | 아니요 | 아니요 |
| No 을(를) | No 을(를) | No 을(를) | False | 아니요 | 아니요 |
1 속성 설정이 null이면 일부 프로그래밍 언어에서는 빈 문자열이 null 문자열과 동일하게 해석되지 않을 수 있습니다.
²The 명령은 여전히 음성으로 액세스할 수 있습니다.
일반적으로 Voice 설정을 사용하여 명령 정의하는 경우 연결된 Commands 컬렉션에 대한 캡션 및 Voice 설정도 정의합니다. 명령 집합에 대한 Commands 컬렉션에 Voice 없거나 캡션 설정이 없고 현재 입력 활성 상태인 경우 그러나 명령 캡션 및 음성 설정이 클라이언트 애플리케이션이 입력 활성 상태가 되면 "(정의되지 않은 명령)" 아래의 음성 명령 창 트리 보기에 명령 표시됩니다.
서버는 Commands 컬렉션에 대해 정의한 Command 개체 중 하나와 일치하는 입력을 받으면 IAgentNotifySink::Command 이벤트를 보내고 명령 ID를 IAgentUserInput 개체의 특성으로 다시 전달합니다. 그런 다음 조건문을 사용하여 명령을 일치시키고 처리할 수 있습니다.
Vtable Order 메서드
| IAgentCommand 메서드 | 묘사 |
|---|---|
| SetCaption | Command 개체의 Caption 값을 설정합니다. |
| GetCaption | Command 개체의 Caption 속성 값을 반환합니다. |
| SetVoice | Command 개체의 Voice 텍스트 값을 설정합니다. |
| GetVoice | Command 개체의 Voice 속성 값을 반환합니다. |
| SetEnabled | Command 개체의 Enabled 속성 값을 설정합니다. |
| GetEnabled | Command 개체의 Enabled 속성 값을 반환합니다. |
| SetVisible | Command 개체의 Visible 속성 값을 설정합니다. |
| GetVisible | Command 개체의 Visible 속성 값을 반환합니다. |
| setConfidenceThreshold | Command 개체의 Confidence 속성 값을 설정합니다. |
| GetConfidenceThreshold | Command 개체의 Confidence 속성 값을 반환합니다. |
| SetConfidenceText | Command 개체의 ConfidenceText 속성 값을 설정합니다. |
| getConfidenceText | Command 개체의 ConfidenceText 속성 값을 반환합니다. |
| getID | Command 개체의 ID를 반환합니다. |