Share via

Metode IDirect3DDevice9::SetDialogBoxMode (d3d9helper.h)

  • Artikel

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

Lihat juga

IDirect3DDevice9