Interaction.AppActivate Metode

Definisi

Ruang nama:

Microsoft.VisualBasic

Rakitan:

Microsoft.VisualBasic.Core.dll

Mengaktifkan aplikasi yang sudah berjalan.

Overload

AppActivate(Int32)	Mengaktifkan aplikasi yang sudah berjalan.
AppActivate(String)	Mengaktifkan aplikasi yang sudah berjalan.

AppActivate(Int32)

Sumber:

Interaction.vb

Mengaktifkan aplikasi yang sudah berjalan.

public:
 static void AppActivate(int ProcessId);

public static void AppActivate (int ProcessId);

static member AppActivate : int -> unit

Public Sub AppActivate (ProcessId As Integer)

Parameter

ProcessId

Int32

Integer menentukan nomor ID proses Win32 yang ditetapkan untuk proses ini. Anda dapat menggunakan ID yang dikembalikan oleh Shell(String, AppWinStyle, Boolean, Int32), asalkan bukan nol.

Contoh

Contoh ini menggambarkan AppActivate berbagai penggunaan fungsi untuk mengaktifkan jendela aplikasi. Jika proses Notepad tidak berjalan, contoh akan menampilkan ArgumentException. Prosedur Shell ini mengasumsikan aplikasi berada di jalur yang ditentukan.

Dim notepadID As Integer
' Activate a running Notepad process.
AppActivate("Untitled - Notepad")
' AppActivate can also use the return value of the Shell function.
' Shell runs a new instance of Notepad.
notepadID = Shell("C:\WINNT\NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the new instance of Notepad.  
AppActivate(notepadID)

Keterangan

Anda menggunakan AppActivate untuk memfokuskan jendela aktif aplikasi. Anda mungkin tidak memiliki handel atau referensi ke jendela aktif, atau bahkan mengetahui jendela mana yang aktif pada saat tertentu. Dalam kasus seperti itu, Anda tidak dapat menggunakan metode .Focus

Fungsi mengubah AppActivate fokus ke aplikasi atau jendela bernama tetapi tidak memengaruhi apakah itu dimaksimalkan atau diminimalkan. Fokus menjauh dari jendela aplikasi yang diaktifkan ketika pengguna mengambil beberapa tindakan untuk mengubah fokus atau menutup jendela. Anda dapat menggunakan Shell fungsi untuk memulai aplikasi dan mengatur gaya jendela.

Jika Anda menggunakan Title parameter , AppActivate menggunakan perbandingan yang tidak peka huruf besar/kecil tetapi sebaliknya memerlukan kecocokan yang tepat dengan konten bilah judul. Ini pertama-tama melihat melalui jendela tingkat atas dan kemudian melalui jendela anak. Jika tidak dapat menemukan kecocokan, ia akan melempar ArgumentException.

Anda hanya dapat menggunakan AppActivate dengan proses yang memiliki jendela. Sebagian besar aplikasi konsol tidak memiliki jendela, yang berarti bahwa aplikasi tersebut tidak muncul dalam daftar proses yang AppActivate dicari. Saat berjalan dari aplikasi konsol, sistem membuat proses terpisah untuk menjalankan aplikasi dan mengembalikan output ke proses konsol. Akibatnya, ketika Anda meminta ID proses saat ini, Anda mendapatkan ID proses dari proses terpisah ini, daripada ID proses aplikasi konsol.

Pada durasi, AppActivate fungsi mengaktifkan aplikasi yang sedang berjalan dengan judul yang cocok Title atau dengan ID proses yang cocok ProcessIddengan . Jika tidak ada kecocokan yang tepat, aplikasi akan mengaktifkan aplikasi apa pun yang string judulnya berakhir dengan Title. Jika ada lebih dari satu aplikasi bernama Title, AppActivate fungsi secara arbitrer memilih satu untuk diaktifkan.

Catatan

Fungsi ini AppActivate membutuhkan UIPermission pada SafeTopLevelWindows tingkat , yang dapat memengaruhi eksekusinya dalam situasi kepercayaan parsial. Untuk informasi selengkapnya, lihat UIPermission .

Lihat juga

• Shell(String, AppWinStyle, Boolean, Int32)
• Focus()
• ArgumentException

AppActivate(String)

Sumber:

Interaction.vb

Mengaktifkan aplikasi yang sudah berjalan.

public:
 static void AppActivate(System::String ^ Title);

public static void AppActivate (string Title);

static member AppActivate : string -> unit

Public Sub AppActivate (Title As String)

Parameter

Title

String

String ekspresi yang menentukan judul di bilah judul aplikasi yang ingin Anda aktifkan. Anda dapat menggunakan judul yang ditetapkan ke aplikasi saat diluncurkan.

Contoh

Contoh ini menggambarkan AppActivate berbagai penggunaan fungsi untuk mengaktifkan jendela aplikasi. Jika proses Notepad tidak berjalan, contoh akan menampilkan ArgumentException. Prosedur Shell ini mengasumsikan aplikasi berada di jalur yang ditentukan.

Dim notepadID As Integer
' Activate a running Notepad process.
AppActivate("Untitled - Notepad")
' AppActivate can also use the return value of the Shell function.
' Shell runs a new instance of Notepad.
notepadID = Shell("C:\WINNT\NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the new instance of Notepad.  
AppActivate(notepadID)

Keterangan

Anda menggunakan AppActivate untuk memfokuskan jendela aktif aplikasi. Anda mungkin tidak memiliki handel atau referensi ke jendela aktif, atau bahkan mengetahui jendela mana yang aktif pada saat tertentu. Dalam kasus seperti itu, Anda tidak dapat menggunakan metode .Focus

Fungsi mengubah AppActivate fokus ke aplikasi atau jendela bernama tetapi tidak memengaruhi apakah itu dimaksimalkan atau diminimalkan. Fokus menjauh dari jendela aplikasi yang diaktifkan ketika pengguna mengambil beberapa tindakan untuk mengubah fokus atau menutup jendela. Anda dapat menggunakan Shell fungsi untuk memulai aplikasi dan mengatur gaya jendela.

Jika Anda menggunakan Title parameter , AppActivate menggunakan perbandingan yang tidak peka huruf besar/kecil tetapi sebaliknya memerlukan kecocokan yang tepat dengan konten bilah judul. Ini pertama-tama melihat melalui jendela tingkat atas dan kemudian melalui jendela anak. Jika tidak dapat menemukan kecocokan, ia akan melempar ArgumentException.

Anda hanya dapat menggunakan AppActivate dengan proses yang memiliki jendela. Sebagian besar aplikasi konsol tidak memiliki jendela, yang berarti bahwa aplikasi tersebut tidak muncul dalam daftar proses yang AppActivate dicari. Saat berjalan dari aplikasi konsol, sistem membuat proses terpisah untuk menjalankan aplikasi dan mengembalikan output ke proses konsol. Akibatnya, ketika Anda meminta ID proses saat ini, Anda mendapatkan ID proses dari proses terpisah ini, daripada ID proses aplikasi konsol.

Pada durasi, AppActivate fungsi mengaktifkan aplikasi yang sedang berjalan dengan judul yang cocok Title atau dengan ID proses yang cocok ProcessIddengan . Jika tidak ada kecocokan yang tepat, aplikasi akan mengaktifkan aplikasi apa pun yang string judulnya berakhir dengan Title. Jika ada lebih dari satu aplikasi bernama Title, AppActivate fungsi secara arbitrer memilih satu untuk diaktifkan.

Catatan

Fungsi ini AppActivate membutuhkan UIPermission pada SafeTopLevelWindows tingkat , yang dapat memengaruhi eksekusinya dalam situasi kepercayaan parsial. Untuk informasi selengkapnya, lihat UIPermission .

Lihat juga

• Shell(String, AppWinStyle, Boolean, Int32)
• Focus()
• ArgumentException