Metodo IPicture::get_CurDC (ocidl.h)
Recupera l'handle del contesto di dispositivo corrente. Questa proprietà è valida solo per le immagini bitmap.
Sintassi
HRESULT get_CurDC(
[out] HDC *phDC
);
Parametri
[out] phDC
Puntatore a una variabile che riceve il contesto di dispositivo.
Valore restituito
Questo metodo supporta il valore restituito standard E_FAIL, nonché i valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
I bit dell'attributo sono stati restituiti correttamente. |
|
Il valore di phDC non è valido. Ad esempio, può essere NULL. |
Commenti
La proprietà CurDC e il metodo IPicture::SelectPicture esistono per aggirare le restrizioni in Windows; in particolare, che un oggetto può essere selezionato solo in un contesto di dispositivo alla volta. In alcuni casi, un oggetto immagine può essere selezionato in modo permanente in un particolare contesto di dispositivo( ad esempio, un controllo può usare una determinata immagine per uno sfondo). Per usare questa proprietà immagine altrove, è necessario deselezionarla temporaneamente dal contesto di dispositivo precedente, selezionata nel nuovo contesto di dispositivo per l'operazione, quindi rielezione nel contesto di dispositivo precedente. Il metodo IPicture::get_CurDC restituisce l'handle del contesto di dispositivo in cui è attualmente selezionata l'immagine. Il metodo IPicture::SelectPicture seleziona l'immagine in un nuovo contesto di dispositivo, restituendo il contesto di dispositivo precedente e l'handle GDI dell'immagine. Il chiamante deve selezionare di nuovo l'immagine nel contesto del dispositivo precedente quando il chiamante viene completato, come avviene normalmente per il codice di Windows.
Note ai chiamanti
Il chiamante possiede sempre tutti i contesti di dispositivo passati tra di esso e l'oggetto immagine. Poiché l'oggetto immagine gestisce una copia di HDC, il chiamante deve usare un contesto di dispositivo di memoria (creato con la funzione CreateCompatibleDC ) e non un contesto di dispositivo dello schermo (da GetDC, CreateDC o BeginPaint), perché i contesti del dispositivo dello schermo sono una risorsa di sistema limitata.Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ocidl.h |