Método IDirect3DDevice9::SetDialogBoxMode (d3d9helper.h)
Esse método permite o uso de caixas de diálogo GDI em aplicativos de modo de tela inteira.
Sintaxe
HRESULT SetDialogBoxMode(
[in] BOOL bEnableDialogs
);
Parâmetros
[in] bEnableDialogs
Tipo: BOOL
TRUE para habilitar caixas de diálogo GDI e FALSE para desabilitá-las.
Valor retornado
Tipo: HRESULT
Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser D3DERR_INVALIDCALL, a menos que todas as opções a seguir sejam verdadeiras.
- O aplicativo especificou um formato de buffer traseiro compatível com GDI, em outras palavras, um dos D3DFMT_X1R5G5B5, D3DFMT_R5G6B5 ou D3DFMT_X8R8G8B8.
- O aplicativo não especificou nenhuma multisampling.
- O aplicativo especificado D3DSWAPEFFECT_DISCARD.
- O aplicativo especificado D3DPRESENTFLAG_LOCKABLE_BACKBUFFER.
- O aplicativo não especificou D3DCREATE_ADAPTERGROUP_DEVICE.
- O aplicativo não está entre BeginScene e EndScene.
Comentários
As caixas de diálogo GDI devem ser criadas como filho para a janela do dispositivo. Eles também devem ser criados no mesmo thread que criou o dispositivo porque isso permite que a janela pai gerencie o redesenho da janela filho.
O método não tem efeito para aplicativos de modo em janelas, mas essa configuração será respeitada se o aplicativo redefinir o dispositivo para o modo de tela inteira. Se SetDialogBoxMode for bem-sucedido em um aplicativo de modo em janelas, qualquer redefinição subsequente para o modo de tela inteira será verificada em relação às restrições listadas acima. Além disso, SetDialogBoxMode faz com que todos os buffers back na cadeia de troca sejam descartados, portanto, espera-se que um aplicativo atualize seu conteúdo para todos os buffers de back após essa chamada.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | d3d9helper.h (inclua D3D9.h) |
| Biblioteca | D3D9.lib |