Komut Nesnesi

[Microsoft Agent, Windows 7 itibariyle kullanım dışıdır ve sonraki Windows sürümlerinde kullanılamayabilir.]

Command nesnesi, Komutları koleksiyonundaki bir öğedir. sunucu, istemci uygulamanız input-active olduğunda Command nesnelerinize kullanıcı erişimi sağlar.

• Komut Nesnesi Özellikleri

Command nesnesinin özelliğine erişmek için, koleksiyondaki bu nesneye Name özelliğini kullanarak başvurursunuz. VBScript ve Visual Basic'te Name özelliğini doğrudan kullanabilirsiniz:

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

Koleksiyonları desteklemeyen programlama dilleri için Command yöntemini kullanın:

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

Ayrıca, bir Command nesnesine referans oluşturarak da erişebilirsiniz. Visual Basic'te bir nesne değişkeni bildirin ve Set deyimini kullanarak başvuruyu oluşturun:

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

Visual Basic 5.0'da, nesneyi IAgentCtlCommandExtürü olarak da bildirebilir ve başvuruyu oluşturabilirsiniz. Bu kural erken bağlamayı etkinleştirir ve bu da daha iyi performans sağlar:

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

VBScript'te bir başvuruyu belirli bir tür olarak bildirebilirsiniz, ancak yine de değişkeni bildirebilir ve koleksiyondaki Command olarak ayarlayabilirsiniz:

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

Bir komut, karakterin açılır menüsünde ve Komutlar Penceresinde veya her ikisinde de görüntülenebilir. Açılır menüde görünmesi için bir resim yazısı olmalı ve Visible özelliğinin Trueolarak ayarlanmış olması gerekir. Ayrıca, Komutlar koleksiyon nesnesi Görünür özelliği de Trueolarak ayarlanmalıdır. Komutlar Penceresinde görünmesi için, KomutResim Yazısı ve Voice özellikleri ayarlanmış olmalıdır. Menü görüntülenirken bir karakterin açılır menü girdilerinin değişmediğini unutmayın. Karakterin açılır menüsü görüntülenirken komutları ekler veya kaldırır ya da özelliklerini değiştirirseniz, kullanıcı menüyü bir sonraki açışında menü bu değişiklikleri gösterir. Ancak Komutlar Penceresi yaptığınız değişiklikleri dinamik olarak yansıtır.

Aşağıdaki tablo, Komut özelliklerinin sunumunu nasıl etkilediğini özetlemektedir.

Caption Özelliği

Voice-Caption Özelliği

Ses Özelliği

Visible Özelliği

Etkin Özellik

Karakterin Açılır Menüsünde görünür

Komutlar Penceresinde görünür

Evet

Evet

Evet

Doğru

Doğru

Normal, Resim Yazısı kullanma

Evet, VoiceCaption kullanma

Evet

Evet

Evet

Doğru

Yanlış

Devre dışı, Resim Yazısı

Hayır

Evet

Evet

Evet

Yanlış

Doğru

Görünmüyor

Evet, VoiceCaption kullanma

Evet

Evet

Evet

Yanlış

Yanlış

Görünmüyor

Hayır

Evet

Evet

Hayır

Doğru

Doğru

Normal, Resim Yazısı kullanma

Hayır

Evet

Evet

Hayır

Doğru

Yanlış

Devre dışı, Altyazı

Hayır

Evet

Evet

Hayır

Yanlış

Doğru

Görünmüyor

Hayır

Evet

Evet

Hayır

Yanlış

Yanlış

Görünmüyor

Hayır

Hayır

Evet

Evet

Doğru

Doğru

Görünmüyor

Evet, VoiceCaption kullanma

Hayır

Evet

Evet

Doğru

Yanlış

Görünmüyor

Hayır

Hayır

Evet

Evet

Yanlış

Doğru

Görünmüyor

Evet, VoiceCaption kullanma

Hayır

Evet

Evet

Yanlış

Yanlış

Görünmüyor

Hayır

Hayır

Evet

Hayır

Doğru

Doğru

Görünmüyor

Hayır

Hayır

Evet

Hayır

Doğru

Yanlış

Görünmüyor

Hayır

Hayır

Evet

Hayır

Yanlış

Doğru

Görünmüyor

Hayır

Hayır

Evet

Hayır

Yanlış

Yanlış

Görünmüyor

Hayır

Evet

Hayır

Evet

Doğru

Doğru

Normal, Resim Yazısı kullanma

Evet, Altyazı kullanma

Evet

Hayır

Evet

Doğru

Yanlış

Devre dışı, Resim Yazısı

Hayır

Evet

Hayır

Evet

Yanlış

Doğru

Görünmüyor

Evet, Altyazı kullanma

Evet

Hayır

Evet

Yanlış

Yanlış

Görünmüyor

Hayır

Evet

Hayır

Hayır

Doğru

Doğru

Normal, Başlık kullanma

Hayır

Evet

Hayır

Hayır

Doğru

Yanlış

Devre dışı bırakıldı, Altyazı

Hayır

Evet

Hayır

Hayır

Yanlış

Doğru

Görünmüyor

Hayır

Evet

Hayır

Hayır

Yanlış

Yanlış

Görünmüyor

Hayır

Hayır

Hayır

Evet

Doğru

Doğru

Görünmüyor

Hayır

Hayır

Hayır

Evet

Doğru

Yanlış

Görünmüyor

Hayır

Hayır

Hayır

Evet

Yanlış

Doğru

Görünmüyor

Hayır

Hayır

Hayır

Evet

Yanlış

Yanlış

Görünmüyor

Hayır

Hayır

Hayır

Hayır

Doğru

Doğru

Görünmüyor

Hayır

Hayır

Hayır

Hayır

Doğru

Yanlış

Görünmüyor

Hayır

Hayır

Hayır

Hayır

Yanlış

Doğru

Görünmüyor

Hayır

Hayır

Hayır

Hayır

Yanlış

Yanlış

Görünmüyor

Hayır

Özellik ayarı boşsa. Bazı programlama dillerinde boş bir dize null dizeyle aynı şekilde yorumlanamayabilir. Komut hala sesle erişilebilir durumdadır.

Sunucu komutlarınızdan biri için giriş aldığında bir Command olayı gönderir ve Command adını UserInput nesnesinin özniteliği olarak geri geçirir. Daha sonra Komutile eşleştirmek ve işlemek için koşullu deyimleri kullanabilirsiniz.