IAgentCommand

[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, kullanıcı tarafından komutlarınıza erişim sağlar ve istemci uygulamanız giriş etkin hale gelir. bir Commandalmak için IAgentCommands::GetCommandçağrısında bulunur.

IAgentCommand, uygulamaların bir karakterin açılır menüsünde ve Sesli Komutlar Penceresinde görüntülenebilen Komut nesneleri için özellikleri ayarlamasına ve sorgulamasına olanak tanıyan bir arabirim tanımlar. Bu işlevler IAgentCommandExde kullanılabilir. Command nesnesi, Komutları koleksiyonundaki bir öğedir. sunucu, istemci uygulamanız giriş etkin hale geldiğinde kullanıcıya komutlarınıza erişim sağlar.

Komut, karakterin açılır menüsünde veya her ikisinde de ve Sesli Komutlar Penceresi'nde görünebilir. Açılır menüde görünmesi için bir Resim Yazısı ve Görünür özelliğinin True olarak ayarlanmış olması gerekir. Komutları koleksiyonu nesnesinin Görünür özelliği, istemci uygulamanız input-active olduğunda komutun açılır menüde görünmesi için True olarak da ayarlanmalıdır. Sesli Komutlar Penceresinde görünmesi için, KomutVoiceCaption ve Voice özellikleri ayarlanmış olmalıdır. (Geriye dönük uyumluluk için VoiceCaption yoksa Caption ayarı kullanılır.)

Menü görüntülenirken bir karakterin açılır menü girdileri değişmez. Karakterin açılır menüsü görüntülenirken Komutları ekler veya kaldırır ya da özelliklerini değiştirirseniz, menü bu değişiklikleri yeniden görüntülendiğinde görüntüler. Ancak, Siz değişiklikleri yaparken Sesli Komutlar Penceresi değişiklikleri görüntüler.

Aşağıdaki tabloda, bir komutun özelliklerinin sununu nasıl etkilediği özetlemektedir.

Caption Özelliği Voice-Caption Özelliği Voice Özelliği Visible Özelliği Karakterin Açılır Menüsünde görünür Sesli Komutlar Penceresinde görünür
Evet Evet Evet Doğru Evet, Resim Yazısı kullanma Evet, VoiceCaption kullanma
Evet Evet Hayır¹ Doğru Evet, Resim Yazısı kullanma Hayır
Evet Evet Evet Yanlış Hayır Evet, VoiceCaption kullanma
Evet Evet Hayır¹ Yanlış Hayır Hayır
Hayır¹ Evet Evet Doğru Hayır Evet, VoiceCaption kullanma
Hayır¹ Evet Evet Yanlış Hayır Evet, VoiceCaption kullanma
Hayır¹ Evet Hayır¹ Doğru Hayır Hayır
Hayır¹ Evet Hayır¹ Yanlış Hayır Hayır
Evet Hayır¹ Evet Doğru Evet, Resim Yazısı kullanma Evet, Resim Yazısı kullanma
Evet Hayır¹ Hayır¹ Doğru Evet Hayır
Evet Hayır¹ Evet Yanlış Hayır Evet, Resim Yazısı kullanma
Evet Hayır¹ Hayır¹ Yanlış Hayır Hayır
Hayır¹ Hayır¹ Evet Doğru Hayır Hayır²
Hayır¹ Hayır¹ Evet Yanlış Hayır Hayır²
Hayır¹ Hayır¹ Hayır¹ Doğru Hayır Hayır
Hayır¹ Hayır¹ Hayır¹ Yanlış Hayır Hayır

 

¹ Özellik ayarı null ise. Bazı programlama dillerinde boş bir dize null dizeyle aynı olarak yorumlanamayabilir.

² Komutun sesine hala erişilebilir.

Genel olarak, Ses ayarıyla bir Komut tanımlarsanız, ilişkili Komutları koleksiyonu için Resim Yazısı ve ses ayarlarını da. Komutlar koleksiyonunda Voice veya Caption ayarı yoksa ve şu anda giriş etkinse, ancak KomutlarCaption ve Voice ayarlarına sahipse, istemci uygulamanız giriş etkin olduğunda Komutları Ses Komutları Pencere ağacı görünümünde "(tanımsız komut)" altında görünür.

Sunucu, Komutları koleksiyonunuz için tanımladığınız Command nesnelerinden biriyle eşleşen bir giriş aldığında, bir IAgentNotifySink::Command olayı gönderir ve komutun kimliğini IAgentUserInput nesnesinin özniteliği olarak geri geçirir. Ardından komutu eşleştirmek ve işlemek için koşullu deyimleri kullanabilirsiniz.

Vtable Order Yöntemleri

IAgentCommand Yöntemleri Açıklama
SetCaption Command nesnesi için Caption değerini ayarlar.
GetCaption Command nesnesinin Caption özelliğinin değerini döndürür.
SetVoice Command nesnesinin Voice metninin değerini ayarlar.
GetVoice Command nesnesinin Voice özelliğinin değerini döndürür.
setEnabled Command nesnesi için Enabled özelliğinin değerini ayarlar.
GetEnabled Command nesnesinin Enabled özelliğinin değerini döndürür.
SetVisible Command nesnesi için Görünür özelliğinin değerini ayarlar.
GetVisible Command nesnesinin Görünür özelliğinin değerini döndürür.
SetConfidenceThreshold Command nesnesi için Güvenilirlik özelliğinin değerini ayarlar.
GetConfidenceThreshold Command nesnesinin Güvenilirlik özelliğinin değerini döndürür.
SetConfidenceText Command nesnesi için ConfidenceText özelliğinin değerini ayarlar.
getConfidenceText Command nesnesinin ConfidenceText özelliğinin değerini döndürür.
getID Command nesnesinin kimliğini döndürür.