Método IDirect3DDevice9::SetDialogBoxMode (d3d9helper.h)

  • Artigo

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

Confira também

IDirect3DDevice9