Insert 메서드

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

Description

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

Syntax

agent**. 문자("CharacterID"). Commands.Insert** Name, RefName, Before_

캡션, 음성, 사용, 표시

부분	Description
이름	필수 요소. 명령에 할당하는 ID에 해당하는 문자열 값입니다.
Refname	필수 사항입니다. 새 명령을 삽입하려는 명령의 이름(ID)에 해당하는 문자열 값입니다.
이전	선택 사항입니다. RefName에서 지정한 명령 앞에 새 명령을 삽입할지 여부를 나타내는 부울 값입니다. True (기본값). 새 명령은 참조된 명령 앞에 삽입됩니다. False 새 명령은 참조된 명령 뒤에 삽입됩니다.
캡션	선택 사항입니다. 클라이언트 애플리케이션이 입력 활성 상태일 때 문자의 팝업 메뉴와 명령 창에 표시되는 이름에 해당하는 문자열 값입니다. 자세한 내용은 Command 개체의 Caption속성을 참조하세요.
음성	선택 사항입니다. 이 명령을 인식하기 위해 음성 엔진에서 사용할 단어 또는 구에 해당하는 문자열 값입니다. 문자열의 대체 서식 지정에 대한 자세한 내용은 Command 개체의 Voice 속성을 참조하세요.
Enabled	선택 사항입니다. 명령이 사용되는지 여부를 나타내는 부울 값입니다. 기본값은 True입니다. 자세한 내용은 Command 개체의 Enabled 속성을 참조하세요.
Visible	선택 사항입니다. 클라이언트 애플리케이션이 입력 활성 상태일 때 명령 창에 명령이 표시되는지 여부를 나타내는 부울 값입니다. 기본값은 True입니다. 자세한 내용은 Command 개체의 Visible 속성을 참조하세요.

설명

Command 개체의 Name 속성 값은 Commands 컬렉션 내에서 고유해야 합니다. 동일한 Name 속성 설정을 사용하여 새 명령을 만들려면 먼저 명령을 제거해야 합니다. Name 속성이 이미 있는 Command를 만들면 오류가 발생합니다.

이 메서드는 Command 개체도 반환합니다. 이렇게 하면 개체를 선언하고 Insert 메서드를 호출할 때 Command를 할당할 수 있습니다.

   Dim Cmd2 as IAgentCtlCommandEx
   Set Cmd2 = Genie.Commands.Insert ("my second command", "my first command",_ True, "Test", "Test", True, True)
   Cmd2.VoiceCaption = "this is a test"

참고 항목

Add 메서드, Remove 메서드, RemoveAll 메서드