Metodo IDirect3DDevice9::SetDialogBoxMode (d3d9helper.h)

Questo metodo consente l'uso delle finestre di dialogo GDI nelle applicazioni in modalità schermo intero.

Sintassi

HRESULT SetDialogBoxMode(
  [in] BOOL bEnableDialogs
);

Parametri

[in] bEnableDialogs

Tipo: BOOL

TRUE per abilitare le finestre di dialogo GDI e FALSE per disabilitarle.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL a meno che tutti i seguenti non siano true.

• L'applicazione ha specificato un formato di buffer back compatibile con GDI, in altre parole, uno di D3DFMT_X1R5G5B5, D3DFMT_R5G6B5 o D3DFMT_X8R8G8B8.
• L'applicazione non ha specificato alcun multicampionamento.
• Applicazione specificata D3DSWAPEFFECT_DISCARD.
• Applicazione specificata D3DPRESENTFLAG_LOCKABLE_BACKBUFFER.
• L'applicazione non ha specificato D3DCREATE_ADAPTERGROUP_DEVICE.
• L'applicazione non è tra BeginScene e EndScene.

Commenti

Le finestre di dialogo GDI devono essere create come figlio nella finestra del dispositivo. Devono anche essere creati all'interno dello stesso thread che ha creato il dispositivo perché consente alla finestra padre di gestire il ridisegno della finestra figlio.

Il metodo non ha alcun effetto per le applicazioni in modalità finestra, ma questa impostazione verrà rispettata se l'applicazione reimposta il dispositivo in modalità schermo intero. Se SetDialogBoxMode ha esito positivo in un'applicazione in modalità finestra, tutte le successive reimpostazioni in modalità schermo intero verranno controllate rispetto alle restrizioni elencate in precedenza. Inoltre, SetDialogBoxMode causa l'eliminazione di tutti i buffer back nella catena di scambio, quindi è previsto che un'applicazione aggiorni il contenuto per tutti i buffer back dopo questa chiamata.

Requisiti

Piattaforma di destinazione	Windows
Intestazione	d3d9helper.h (include D3D9.h)
Libreria	D3D9.lib

Vedi anche

IDirect3DDevice9