Command 개체

  • 아티클

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

Command 개체는 Commands 컬렉션의 항목입니다. 서버는 클라이언트 애플리케이션이 입력 활성 상태가 될 때 Command 개체에 대한 사용자 액세스를 제공합니다.

Command 개체의 속성에 액세스하려면 Name 속성을 사용하여 컬렉션에서 참조합니다. VBScript 및 Visual Basic에서는 Name 속성을 직접 사용할 수 있습니다.

   <i>agent</i>.Characters("<i>CharacterID</i>").Commands("<i>Name</i>").<i>property</i> [= <i>value</i>]

컬렉션을 지원하지 않는 프로그래밍 언어의 경우 Command 메서드를 사용합니다.

   <i>agent</i>.Characters("<i>CharacterID</i>").Commands.Command("<i>Name</i>").<i>property</i> [= <i>value</i>]

Command 개체에 대한 참조를 만들어서 참조할 수도 있습니다. Visual Basic에서 개체 변수를 선언하고 Set 문을 사용하여 참조를 만듭니다.

   Dim Cmd1 as Object
   ...
   Set Cmd1 = Agent.Characters("MyCharacterID").Commands("SampleCommand")
   ...
   Cmd1.Enabled = True

Visual Basic 5.0에서는 개체를 IAgentCtlCommandEx 형식으로 선언하고 참조를 만들 수도 있습니다. 이 규칙을 사용하면 초기 바인딩이 가능하므로 성능이 향상됩니다.

   Dim Cmd1 as IAgentCtlCommandEx
   ...
   Set Cmd1 = Agent.Characters("MyCharacterID").Commands("SampleCommand")
   ...
   Cmd1.Enabled = True

VBScript에서 참조를 특정 형식으로 선언할 수 있지만 변수를 선언하고 컬렉션의 Command 로 설정할 수 있습니다.

   Dim Cmd1
   ...
   Set Cmd1 = Agent.Characters("MyCharacterID").Commands("SampleCommand")
   ...
   Cmd1.Enabled = True

명령이 문자의 팝업 메뉴와 명령 창 또는 둘 다에 나타날 수 있습니다. 팝업 메뉴에 표시하려면 캡션 있어야 하며 Visible 속성이 True로 설정되어 있어야 합니다. 또한 Commands 컬렉션 개체 Visible 속성도 True로 설정해야 합니다. 명령 창에 표시하려면 명령에캡션 및 음성 속성이 설정되어 있어야 합니다. 메뉴가 표시되는 동안에는 문자의 팝업 메뉴 항목이 변경되지 않습니다. 문자의 팝업 메뉴가 표시되는 동안 명령을 추가하거나 제거하거나 해당 속성을 변경하면 사용자가 다음에 표시할 때마다 메뉴에 변경 내용이 표시됩니다. 그러나 명령 창에는 변경한 내용이 동적으로 반영됩니다.

다음 표에서는 명령 의 속성이 프레젠테이션에 미치는 영향을 요약합니다.

Caption 속성

Voice-Caption 속성

Voice 속성

Visible 속성

Enabled 속성

문자의 팝업 메뉴에 나타납니다.

명령 창에 표시

Yes

Yes

Yes

True

True

일반, 캡션 사용

예, VoiceCaption 사용

Yes

Yes

Yes

True

거짓

사용 안 함, 캡션 사용

아니요

예

Yes

예

False

True

표시되지 않음

예, VoiceCaption 사용

Yes

Yes

예

False

거짓

표시되지 않음

아니요

예

Yes

아니요

True

True

일반, 캡션 사용

아니요

예

Yes

아니요

True

거짓

사용 안 함, 캡션 사용

아니요

예

Yes

아니요

False

True

표시되지 않음

아니요

예

Yes

아니요

False

거짓

표시되지 않음

아니요

아니요

예

Yes

True

True

표시되지 않음

예, VoiceCaption 사용

아니요

예

Yes

True

거짓

표시되지 않음

아니요

아니요

예

예

False

True

표시되지 않음

예, VoiceCaption 사용

아니요

예

예

False

거짓

표시되지 않음

아니요

아니요

예

아니요

True

True

표시되지 않음

아니요

아니요

예

아니요

True

거짓

표시되지 않음

아니요

아니요

예

아니요

False

True

표시되지 않음

아니요

아니요

예

아니요

False

거짓

표시되지 않음

아니요

예

아니요

예

True

True

일반, 캡션 사용

예, 캡션 사용

Yes

아니요

예

True

거짓

사용 안 함, 캡션 사용

아니요

예

아니요

예

False

True

표시되지 않음

예, 캡션 사용

Yes

아니요

예

False

거짓

표시되지 않음

아니요

예

아니요

아니요

True

True

일반, 캡션 사용

아니요

예

아니요

아니요

True

거짓

사용 안 함, 캡션 사용

아니요

예

아니요

아니요

False

True

표시되지 않음

아니요

예

아니요

아니요

False

거짓

표시되지 않음

아니요

아니요

아니요

예

True

True

표시되지 않음

아니요

아니요

아니요

예

True

거짓

표시되지 않음

아니요

아니요

아니요

예

False

True

표시되지 않음

아니요

아니요

아니요

예

False

거짓

표시되지 않음

아니요

아니요

아니요

아니요

True

True

표시되지 않음

아니요

아니요

아니요

아니요

True

거짓

표시되지 않음

아니요

아니요

아니요

아니요

False

True

표시되지 않음

아니요

아니요

아니요

아니요

False

거짓

표시되지 않음

No

속성 설정이 null이면 입니다. 일부 프로그래밍 언어에서는 빈 문자열이 null 문자열과 동일하게 해석되지 않을 수 있습니다. 명령은 여전히 음성에 액세스할 수 있습니다.

서버는 명령 중 하나에 대한 입력을 받으면 Command 이벤트를 보내고 Command 의 이름을 UserInput 개체의 특성으로 다시 전달합니다. 그런 다음 조건문을 사용하여 명령을 일치시키고 처리할 수 있습니다.