Interaction.AppActivate Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengaktifkan aplikasi yang sudah berjalan.
Overload
| Nama | Deskripsi |
|---|---|
| AppActivate(Int32) |
Mengaktifkan aplikasi yang sudah berjalan. |
| AppActivate(String) |
Mengaktifkan aplikasi yang sudah berjalan. |
AppActivate(Int32)
Mengaktifkan aplikasi yang sudah berjalan.
public:
static void AppActivate(int ProcessId);public static void AppActivate(int ProcessId);static member AppActivate : int -> unitPublic 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 , asalkan Shell(String, AppWinStyle, Boolean, Int32)bukan nol.
Contoh
Contoh ini menggambarkan AppActivate berbagai penggunaan fungsi untuk mengaktifkan jendela aplikasi. Jika proses Notepad tidak berjalan, contohnya akan melempar ArgumentException. Prosedur Shell mengasumsikan bahwa aplikasi berada di jalur yang telah 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 saat 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 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 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 run time, AppActivate fungsi mengaktifkan aplikasi yang sedang berjalan dengan judul yang cocok Title atau dengan ID proses yang cocok ProcessId. Jika tidak ada kecocokan yang tepat, itu mengaktifkan aplikasi apa pun yang string judulnya diakhir dengan Title. Jika ada lebih dari satu aplikasi bernama Title, AppActivate fungsi secara segan-segan memilih satu untuk diaktifkan.
Note
Fungsi ini AppActivate memerlukan UIPermission pada SafeTopLevelWindows tingkat , yang dapat memengaruhi eksekusinya dalam situasi kepercayaan parsial. Untuk informasi selengkapnya, lihat UIPermission .
Lihat juga
Berlaku untuk
AppActivate(String)
Mengaktifkan aplikasi yang sudah berjalan.
public:
static void AppActivate(System::String ^ Title);public static void AppActivate(string Title);static member AppActivate : string -> unitPublic 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, contohnya akan melempar ArgumentException. Prosedur Shell mengasumsikan bahwa aplikasi berada di jalur yang telah 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 saat 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 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 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 run time, AppActivate fungsi mengaktifkan aplikasi yang sedang berjalan dengan judul yang cocok Title atau dengan ID proses yang cocok ProcessId. Jika tidak ada kecocokan yang tepat, itu mengaktifkan aplikasi apa pun yang string judulnya diakhir dengan Title. Jika ada lebih dari satu aplikasi bernama Title, AppActivate fungsi secara segan-segan memilih satu untuk diaktifkan.
Note
Fungsi ini AppActivate memerlukan UIPermission pada SafeTopLevelWindows tingkat , yang dapat memengaruhi eksekusinya dalam situasi kepercayaan parsial. Untuk informasi selengkapnya, lihat UIPermission .