Metode IDirect3DDevice9::SetDialogBoxMode (d3d9helper.h)
Metode ini memungkinkan penggunaan kotak dialog GDI dalam aplikasi mode layar penuh.
Sintaks
HRESULT SetDialogBoxMode(
[in] BOOL bEnableDialogs
);
Parameter
[in] bEnableDialogs
Jenis: BOOL
TRUE untuk mengaktifkan kotak dialog GDI, dan FALSE untuk menonaktifkannya.
Mengembalikan nilai
Jenis: HRESULT
Jika metode berhasil, nilai yang dikembalikan D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat D3DERR_INVALIDCALL kecuali semua hal berikut ini benar.
- Aplikasi menentukan format buffer belakang yang kompatibel dengan GDI, dengan kata lain, salah satu D3DFMT_X1R5G5B5, D3DFMT_R5G6B5, atau D3DFMT_X8R8G8B8.
- Aplikasi tidak menentukan multisampling.
- Aplikasi yang ditentukan D3DSWAPEFFECT_DISCARD.
- Aplikasi yang ditentukan D3DPRESENTFLAG_LOCKABLE_BACKBUFFER.
- Aplikasi tidak menentukan D3DCREATE_ADAPTERGROUP_DEVICE.
- Aplikasi ini bukan antara BeginScene dan EndScene.
Keterangan
Kotak dialog GDI harus dibuat sebagai anak ke jendela perangkat. Mereka juga harus dibuat dalam utas yang sama yang membuat perangkat karena ini memungkinkan jendela induk untuk mengelola penggalian ulang jendela anak.
Metode ini tidak berpengaruh untuk aplikasi mode berjendela, tetapi pengaturan ini akan dihormati jika aplikasi mengatur ulang perangkat ke mode layar penuh. Jika SetDialogBoxMode berhasil dalam aplikasi mode berjendela, setiap reset berikutnya ke mode layar penuh akan diperiksa terhadap pembatasan yang tercantum di atas. Selain itu, SetDialogBoxMode menyebabkan semua buffer belakang pada rantai pertukaran dibuang, sehingga aplikasi diharapkan untuk menyegarkan kontennya untuk semua buffer belakang setelah panggilan ini.
Persyaratan
| Target Platform | Windows |
| Header | d3d9helper.h (termasuk D3D9.h) |
| Pustaka | D3D9.lib |