perintah jendela

Perintah jendela mengontrol jendela tampilan. Anda dapat menggunakan perintah ini untuk mengubah karakteristik tampilan jendela atau menyediakan jendela tujuan untuk digunakan driver sebagai pengganti jendela tampilan default. Perangkat digital-video, dan video-overlay mengenali perintah ini.

Untuk mengirim perintah ini, panggil fungsi mciSendString dengan parameter lpszCommand yang ditetapkan sebagai berikut.

_stprintf_s(
  lpszCommand, 
  TEXT("window %s %s %s"), 
  lpszDeviceID, 
  lpszWindowFlags, 
  lpszFlags
); 

Parameter

lpszDeviceID

Pengidentifikasi perangkat MCI. Pengidentifikasi atau alias ini ditetapkan saat perangkat dibuka.

lpszWindowFlags

Bendera untuk mengontrol jendela tampilan. Tabel berikut ini mencantumkan jenis perangkat yang mengenali perintah jendela dan bendera yang digunakan oleh setiap jenis.

Nilai	Makna	Makna
digitalvideo	menangani status hwnd hidestate meminimalkanstate restorestate showshow dimaksimalkan	show minimizedshow min noactiveshow nashow noactivateshow normaltext caption
Overlay	fixedhandle defaulthandle hwnd state hidestate iconicstate maximizedstate minimizestate minimizedstate no actionstate noactivatestate normal	state restorestate showshow maximizedshow minimizedshow min noactiveshow nashow noactivateshow normalstretchtext caption

Tabel berikut mencantumkan bendera yang dapat ditentukan dalam parameter lpszWindowFlags dan maknanya.

Nilai	Makna
diperbaiki	Menonaktifkan peregangan gambar.
menangani default	Menentukan bahwa perangkat harus mengatur kembali jendela tampilan ke jendela default yang dibuat selama operasi terbuka . Untuk perangkat video-overlay, menentukan bahwa perangkat harus membuat dan mengelola jendela tujuannya sendiri.
handel hwnd	Menentukan handel jendela tujuan yang akan digunakan alih-alih jendela default. Parameter hwnd berisi numerik ASCII yang setara dengan handel jendela yang dikembalikan oleh fungsi CreateWindow . Dua instans perangkat dapat menggunakan handel jendela yang sama asalkan setiap instans memperbarui piksel video dan gambar di jendela seolah-olah instans lain tidak ada. Ketika output video dinonaktifkan dengan setvideo "off", perintah pembaruan akan membuat persegi panjang tujuan menjadi warna solid.
tampilkan dimaksimalkan	Memaksimalkan jendela tujuan.
tampilkan min noaktif	Menampilkan jendela tujuan sebagai ikon.
tampilkan diminimalkan	Meminimalkan jendela tujuan.
tampilkan na	Menampilkan jendela tujuan dalam statusnya saat ini; jendela yang saat ini aktif tetap aktif.
perlihatkan noaktivasi	Menampilkan jendela tujuan dalam ukuran dan posisi terbarunya; jendela yang saat ini aktif tetap aktif.
tampilkan normal	Mengaktifkan dan menampilkan jendela tujuan dalam ukuran dan posisi aslinya. (Ini sama dengan bendera "pemulihan status".)
sembunyikan status	Menyembunyikan jendela tujuan.
status ikonik	Menampilkan jendela tujuan sebagai ikon.
status dimaksimalkan	Memaksimalkan jendela tujuan.
status meminimalkan	Meminimalkan jendela tujuan dan mengaktifkan jendela tingkat atas dalam daftar manajer jendela.
status diminimalkan	Meminimalkan jendela tujuan.
status tidak ada tindakan	Menampilkan jendela tujuan dalam status saat ini. Jendela yang saat ini aktif tetap aktif.
status tidak aktif	Menampilkan jendela tujuan dalam ukuran dan status terbarunya. Jendela yang saat ini aktif tetap aktif.
status normal	Mengaktifkan dan menampilkan jendela tujuan dalam ukuran dan posisi aslinya.
pemulihan status	Mengaktifkan dan menampilkan jendela tujuan dalam ukuran dan posisi aslinya.
peragaan status	Memperlihatkan jendela tujuan.
Stretch	Memungkinkan peregangan gambar.
caption teks	Menentukan caption untuk jendela tujuan. Jika teks ini berisi kosong yang disematkan, seluruh caption harus diapit dalam tanda kutip. Caption default untuk jendela default kosong.

lpszFlags

Bisa "tunggu", "beri tahu", atau keduanya. Untuk perangkat video digital, "pengujian" juga dapat ditentukan. Untuk informasi selengkapnya tentang bendera ini, lihat Bendera Tunggu, Beri Tahu, dan Uji.

Tampilkan Nilai

Mengembalikan nol jika berhasil atau kesalahan sebaliknya.

Keterangan

Perangkat video-overlay biasanya membuat dan menampilkan jendela saat dibuka. Jika aplikasi Anda menyediakan jendela ke driver, aplikasi Anda bertanggung jawab untuk mengelola pesan yang dikirim ke jendela.

Karena Anda dapat menggunakan perintah status untuk mengambil handel ke jendela tampilan driver, Anda juga dapat menggunakan fungsi manajer jendela standar (seperti ShowWindow) untuk memanipulasi jendela.

Contoh

Perintah berikut menampilkan dan mengatur caption untuk jendela pemutaran "film".

window movie text "Welcome to the Movies" state show

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]

Lihat juga

MCI

String Perintah MCI

Terbuka

Bermain

setvideo

pembaruan