Aktifkan Metode

[Microsoft Agent tidak digunakan lagi pada Windows 7, dan mungkin tidak tersedia dalam versi Windows berikutnya.]

Deskripsi

Mengatur klien atau karakter aktif.

Sintaks

agen**. Karakter ("CharacterID "). Aktifkan** [Status]

Bagian	Deskripsi
Status	Fakultatif. Anda dapat menentukan nilai berikut untuk parameter ini: 0 Bukan klien aktif. 1 Klien aktif. 2 (Default) Karakter paling atas.

Komentar

Saat beberapa karakter terlihat, hanya satu karakter yang menerima input ucapan pada satu waktu. Demikian pula, ketika beberapa aplikasi klien memiliki karakter yang sama, hanya salah satu klien yang menerima input mouse (misalnya, klik kontrol Agen Microsoft atau peristiwa seret). Karakter yang diatur untuk menerima input mouse dan ucapan adalah karakter paling atas dan klien yang menerima input adalah klien aktif karakter tersebut. (Jendela karakter paling atas juga muncul di bagian atas z-order jendela karakter.) Biasanya, pengguna menentukan karakter paling atas dengan secara eksplisit memilih karakter. Namun, aktivasi paling atas juga berubah ketika karakter ditampilkan atau disembunyikan (karakter menjadi atau tidak lagi paling atas, masing-masing.)

Anda juga dapat menggunakan metode ini untuk mengelola secara eksplisit ketika klien Anda menerima input yang diarahkan ke karakter seperti ketika aplikasi Anda sendiri menjadi aktif. Misalnya, pengaturan State ke 2 membuat karakter paling atas dan klien Anda menerima semua peristiwa input mouse dan ucapan yang dihasilkan dari interaksi pengguna dengan karakter. Oleh karena itu, ini juga menjadikan klien Anda sebagai klien input-aktif karakter.

Namun, Anda juga dapat mengatur diri Anda menjadi klien aktif untuk karakter tanpa membuat karakter paling atas, dengan mengatur Status ke 1. Ini memungkinkan klien Anda untuk menerima input yang diarahkan ke karakter tersebut ketika karakter menjadi paling atas. Demikian pula, Anda dapat mengatur klien Anda agar tidak menjadi klien aktif (tidak menerima input) ketika karakter menjadi paling atas, dengan mengatur Status ke 0.

Hindari memanggil metode ini langsung setelah metode Tampilkan. Tampilkan secara otomatis mengatur klien input-active. Saat karakter disembunyikan, panggilan Aktifkan mungkin gagal jika diproses sebelum metode Tampilkan selesai.

Jika Anda memanggil metode ini ke fungsi, metode ini mengembalikan nilai Boolean yang menunjukkan apakah metode berhasil. Mencoba memanggil metode ini dengan parameter Status diatur ke 2 ketika karakter yang ditentukan disembunyikan akan gagal. Demikian pula, jika Anda mengatur State ke 0 dan aplikasi Anda adalah satu-satunya klien, panggilan ini gagal karena karakter harus selalu memiliki klien teratas.

   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

Nota

Memanggil metode ini dengan status diatur ke 1 biasanya tidak menghasilkan peristiwa ActivateInput kecuali tidak ada karakter lain yang dimuat atau aplikasi Anda sudah aktif input.

Lihat Juga

peristiwa ActivateInputperistiwa , NonaktifkanInput