Metodo IDirect3DDevice9::SetDialogBoxMode (d3d9.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 | d3d9.h (includere D3D9.h) |
| Libreria | D3D9.lib |