Oggetto Command

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

Un oggetto Command è un elemento in un insieme Commands . Il server fornisce all'utente l'accesso agli oggetti Command quando l'applicazione client diventa attiva.

• Proprietà dell'oggetto Command

Per accedere alla proprietà di un oggetto Command , fare riferimento all'insieme usando la relativa proprietà Name . In VBScript e Visual Basic è possibile usare direttamente la proprietà Name :

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

Per i linguaggi di programmazione che non supportano le raccolte, usare il metodo Command :

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

È anche possibile fare riferimento a un oggetto Command creando un riferimento. In Visual Basic dichiarare una variabile oggetto e usare l'istruzione Set per creare il riferimento:

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

In Visual Basic 5.0 è anche possibile dichiarare l'oggetto come tipo IAgentCtlCommandEx e creare il riferimento. Questa convenzione consente l'associazione anticipata, che comporta prestazioni migliori:

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

In VBScript è possibile dichiarare un riferimento come tipo specifico, ma è comunque possibile dichiarare la variabile e impostarla sul comando nella raccolta:

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

Un comando può essere visualizzato nel menu a comparsa del carattere e nella finestra comandi o in entrambi. Per essere visualizzato nel menu a comparsa, deve avere un didascalia e avere la proprietà Visible impostata su True. Inoltre, la proprietà Visible dell'insieme Commands deve essere impostata anche su True. Per essere visualizzato nella finestra comandi, un comando deve avere le proprietà Didascalia e Voce impostate. Si noti che le voci di menu popup di un carattere non cambiano mentre viene visualizzato il menu. Se si aggiungono o si rimuoveno i comandi o si modificano le proprietà mentre viene visualizzato il menu popup del carattere, il menu visualizza tali modifiche ogni volta che l'utente lo visualizza. Tuttavia, la finestra comandi riflette dinamicamente tutte le modifiche apportate.

Nella tabella seguente viene riepilogato il modo in cui le proprietà di un comando influiscono sulla relativa presentazione:

Proprietà Caption

Voice-Caption, proprietà

Voice, proprietà

Visible, proprietà

Proprietà Enabled

Viene visualizzato nel menu a comparsa del carattere

Viene visualizzato nella finestra comandi

Sì

Sì

Sì

True

True

Normale, uso di didascalia

Sì, usando VoiceCaption

Sì

Sì

Sì

True

Falso

Disabilitato, usando didascalia

No

Sì

Sì

Sì

False

True

Non viene visualizzato

Sì, usando VoiceCaption

Sì

Sì

Sì

False

Falso

Non viene visualizzato

No

Sì

Sì

No

True

True

Normale, uso di didascalia

No

Sì

Sì

No

Vero

Falso

Disabilitato, usando didascalia

No

Sì

Sì

No

False

True

Non viene visualizzato

No

Sì

Sì

No

False

Falso

Non viene visualizzato

No

No

Sì

Sì

True

True

Non viene visualizzato

Sì, usando VoiceCaption

No

Sì

Sì

True

Falso

Non viene visualizzato

No

No

Sì

Sì

False

True

Non viene visualizzato

Sì, usando VoiceCaption

No

Sì

Sì

False

Falso

Non viene visualizzato

No

No

Sì

No

True

True

Non viene visualizzato

No

No

Sì

No

True

Falso

Non viene visualizzato

No

No

Sì

No

False

True

Non viene visualizzato

No

No

Sì

No

False

Falso

Non viene visualizzato

No

Sì

No

Sì

True

True

Normale, uso della didascalia

Sì, usando Didascalia

Sì

No

Sì

Vero

Falso

Disabilitato, usando Didascalia

No

Sì

No

Sì

False

True

Non viene visualizzato

Sì, usando Didascalia

Sì

No

Sì

False

Falso

Non viene visualizzato

No

Sì

No

No

True

True

Normale, uso della didascalia

No

Sì

No

No

Vero

Falso

Disabilitato, usando Didascalia

No

Sì

No

No

False

True

Non viene visualizzato

No

Sì

No

No

False

Falso

Non viene visualizzato

No

No

No

Sì

True

True

Non viene visualizzato

No

No

No

Sì

True

Falso

Non viene visualizzato

No

No

No

Sì

False

True

Non viene visualizzato

No

No

No

Sì

False

Falso

Non viene visualizzato

No

No

No

No

True

True

Non viene visualizzato

No

No

No

No

Vero

Falso

Non viene visualizzato

No

No

No

No

False

True

Non viene visualizzato

No

No

No

No

False

Falso

Non viene visualizzato

No

Se l'impostazione della proprietà è Null. In alcuni linguaggi di programmazione, una stringa vuota potrebbe non essere interpretata come una stringa Null. Il comando è ancora accessibile dalla voce.

Quando il server riceve l'input per uno dei comandi, invia un evento Command e passa il nome del comando come attributo dell'oggetto UserInput . È quindi possibile usare istruzioni condizionali per corrispondere ed elaborare il comando.