IPicture::get_CurDC-Methode (ocidl.h)
Ruft das Handle des aktuellen Gerätekontexts ab. Diese Eigenschaft ist nur für Bitmapbilder gültig.
Syntax
HRESULT get_CurDC(
[out] HDC *phDC
);
Parameter
[out] phDC
Ein Zeiger einer Variablen, die den Gerätekontext empfängt.
Rückgabewert
Diese Methode unterstützt den Standardrückgabewert E_FAIL sowie die folgenden Werte.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Attributbits wurden erfolgreich zurückgegeben. |
|
Der Wert von phDC ist ungültig. Es kann z. B. NULL sein. |
Hinweise
Die CurDC-Eigenschaft und die IPicture::SelectPicture-Methode sind vorhanden, um Einschränkungen in Windows zu umgehen. insbesondere, dass ein Objekt nur in jeweils genau einem Gerätekontext ausgewählt werden kann. In einigen Fällen kann ein Bildobjekt dauerhaft in einem bestimmten Gerätekontext ausgewählt werden (beispielsweise kann ein Steuerelement ein bestimmtes Bild für einen Hintergrund verwenden). Um diese Bildeigenschaft an anderer Stelle verwenden zu können, muss sie vorübergehend aus dem alten Gerätekontext entfernt, in den neuen Gerätekontext für den Vorgang ausgewählt und dann wieder in den alten Gerätekontext zurückgewählt werden. Die IPicture::get_CurDC-Methode gibt das Gerätekontexthandle zurück, in dem das Bild derzeit ausgewählt ist. Die IPicture::SelectPicture-Methode wählt das Bild in einen neuen Gerätekontext aus und gibt den alten Gerätekontext und das GDI-Handle des Bilds zurück. Der Aufrufer sollte das Bild wieder in den alten Gerätekontext zurückwählen, wenn der Aufrufer damit fertig ist, wie es für Windows-Code normal ist.
Hinweise für Anrufer
Der Aufrufer besitzt immer alle Gerätekontexte, die zwischen dem Objekt und dem Bildobjekt übergeben werden. Da das Bildobjekt eine Kopie des HDC verwaltet, sollte der Aufrufer einen Speichergerätekontext (erstellt mit der CreateCompatibleDC-Funktion ) und keinen Bildschirmgerätekontext (aus GetDC, CreateDC oder BeginPaint) verwenden, da die Bildschirmgerätekontexte eine begrenzte Systemressource sind.Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ocidl.h |