IPicture::get_CurDC-Methode (ocidl.h)

  • Artikel

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
S_OK
 Die Attributbits wurden erfolgreich zurückgegeben.
E_POINTER
 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

Weitere Informationen

Ipicture

IPicture::SelectPicture