Activate, metoda

[Program Microsoft Agent jest przestarzały w systemie Windows 7 i może być niedostępny w kolejnych wersjach systemu Windows.

Opis

Ustawia aktywnego klienta lub znak.

składni

agent**. Znaki ("Identyfikator znaku"). Activate** [State]

Część	Opis
stanu	Fakultatywny. Dla tego parametru można określić następujące wartości: 0 Nie jest aktywnym klientem. 1 Aktywny klient. 2 (Ustawienie domyślne) Najbardziej górny znak.

Uwagi

Gdy wiele znaków jest widocznych, tylko jeden z znaków otrzymuje dane wejściowe mowy naraz. Podobnie, gdy wiele aplikacji klienckich ma ten sam znak, tylko jeden z klientów otrzymuje dane wejściowe myszy (na przykład kliknięcie lub przeciągnięcie zdarzeń przez program Microsoft Agent). Zestaw znaków odbierający dane wejściowe myszy i mowy jest najwyższym znakiem, a klient odbierający dane wejściowe jest aktywnym klientem tego znaku. (Okno najbardziej górnego znaku pojawia się również w górnej części okna znaków z-order). Zazwyczaj użytkownik określa najbardziej górny znak, jawnie wybierając znak. Jednak najbardziej górna aktywacja również zmienia się, gdy znak jest wyświetlany lub ukryty (znak staje się lub nie jest już najbardziej górny, odpowiednio).

Można również użyć tej metody, aby jawnie zarządzać, gdy klient odbiera dane wejściowe kierowane do znaku, na przykład gdy sama aplikacja staje się aktywna. Na przykład ustawienie State na 2 powoduje, że znak jest najwyższy, a klient otrzymuje wszystkie zdarzenia wprowadzania myszy i mowy wygenerowane na podstawie interakcji użytkownika z znakiem. W związku z tym klient staje się również klientem wejściowym aktywnego znaku.

Można jednak ustawić jako aktywny klient dla znaku bez ustawiania najwyższego poziomu znaku, ustawiając stan na 1. Dzięki temu klient może odbierać dane wejściowe skierowane do tego znaku, gdy znak staje się najbardziej górny. Podobnie można ustawić klienta tak, aby nie był aktywnym klientem (nie odbierać danych wejściowych), gdy znak staje się najwyższy, ustawiając stan na 0.

Unikaj wywoływania tej metody bezpośrednio po metodzie Show. Pokaż automatycznie ustawia klienta wejściowego aktywnego. Gdy znak jest ukryty, wywołanie Aktywuj może zakończyć się niepowodzeniem, jeśli zostanie przetworzone przed ukończeniem metody Show.

Jeśli wywołasz tę metodę do funkcji, zwraca wartość logiczną wskazującą, czy metoda powiodła się. Próba wywołania tej metody za pomocą parametru State ustawiona na 2, gdy określony znak jest ukryty, zakończy się niepowodzeniem. Podobnie, jeśli ustawisz stan na 0, a aplikacja jest jedynym klientem, to wywołanie zakończy się niepowodzeniem, ponieważ znak musi zawsze mieć klienta najwyższego poziomu.

   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

Nuta

Wywołanie tej metody przy użyciu stanu ustawionego na 1 nie generuje zazwyczaj zdarzenia ActivateInput, chyba że nie ma żadnych innych znaków załadowanych lub aplikacja jest już aktywna.

Zobacz też

zdarzeń ActivateInput Dezaktywujinput