Activate Yöntemi

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

Açıklama

Etkin istemciyi veya karakteri ayarlar.

Sözdizimi

aracı**. Karakterler ("CharacterID"). Etkinleştirme** [State]

Kısım	Açıklama
State	Opsiyonel. Bu parametre için aşağıdaki değerleri belirtebilirsiniz: 0 Etkin istemci değil. 1 Etkin istemci. 2 (Varsayılan) En üstteki karakter.

Açıklamalar

Birden çok karakter görünür olduğunda, karakterlerden yalnızca biri aynı anda konuşma girişi alır. Benzer şekilde, birden çok istemci uygulaması aynı karakteri paylaştığında, istemcilerden yalnızca biri fare girişi alır (örneğin, Microsoft Aracısı denetimi tıklama veya sürükleme olayları). Fare ve konuşma girişini almak için ayarlanan karakter en üstteki karakterdir ve girişi alan istemci de bu karakterin etkin istemcisidir. (En üstteki karakter penceresi, karakter penceresinin z sırasının en üstünde de görünür.) Genellikle kullanıcı, karakteri açıkça seçerek en üstteki karakteri belirler. Ancak, en üstteki etkinleştirme, bir karakter gösterildiğinde veya gizlendiğinde de değişir (karakter sırasıyla en üstte olur veya artık en üstte olmaz).)

Ayrıca, istemcinizin karakterine yönlendirilen girişi (örneğin, uygulamanızın kendisi etkin olduğunda) ne zaman alacağını açıkça yönetmek için de bu yöntemi kullanabilirsiniz. Örneğin, State değerinin 2 olarak ayarlanması karakteri en üstte yapar ve istemciniz karakterle kullanıcı etkileşiminden oluşturulan tüm fare ve konuşma giriş olaylarını alır. Bu nedenle, istemcinizi karakterin giriş-etkin istemcisi yapar.

Ancak, State değerini 1 olarak ayarlayarak, karakteri en üstte yapmadan bir karakter için etkin istemci olarak da ayarlayabilirsiniz. Bu, istemcinizin karakter en üst düzeye çıktığında bu karaktere yönlendirilen girişi almasını sağlar. Benzer şekilde, State değerini 0 olarak ayarlayarak, karakter en üst düzeye çıktığında istemcinizi etkin istemci (giriş almamak) olarak ayarlayabilirsiniz.

Show yönteminden hemen sonra bu yöntemi çağırmaktan kaçının. Show, input-active istemcisini otomatik olarak ayarlar. Karakter gizlendiğinde, Göster yöntemi tamamlanmadan önce işlenirse Etkinleştir çağrısı başarısız olabilir.

Bu yöntemi bir işleve çağırırsanız, yöntemin başarılı olup olmadığını gösteren bir Boole değeri döndürür. Belirtilen karakter gizlendiğinde State parametresi 2 olarak ayarlanmış olarak bu yöntemi çağırma girişimi başarısız olur. Benzer şekilde, State değerini 0 olarak ayarlarsanız ve uygulamanız tek istemciyse, bir karakterin her zaman en üstteki istemciye sahip olması gerektiğinden bu çağrı başarısız olur.

   Dim Genie as Object

   Sub FormLoad()

   Agent1.Characters.Load "Genie", "Genie.acs"

   Set Genie = Agent1.Characters ("Genie")

   If (Genie. Activate = True) Then
      'I'm active

   Else
      'I must be hidden or something

   End If 
   
   End Sub

Ayrıca Bkz.

ActivateInput olayıDeactivateInput olay