CreateCompatibleDC
Die API-Funktion CreateCompatibleDC erzeugt zu einem angegebenen Gerät einen kompatiblen Gerätekontext (DC).
Declare Function CreateCompatibleDC Lib "gdi32" ( _
ByVal hdc As Long) As Long
Parameter
hdc
- [IN] Erwartet das Handle zu einem existierenden Gerätekontext.
- Bei keiner Eingabe wird ein zu dem aktuellen Bildschirm kompatibles DC erstellt.
Rückgabe(n)
Bei Erfolg wird das Handle des kompatiblen Gerätekontext zurückgegeben, bei Misserfolg "0". Für nähere Informationen zu letzteren Fall kann die Funktion Err.LastDLLError verwandt werden.
Nähere Informationen
Die Funktion CreateCompatibleDC erzeugt im Speicher ein Geräteabbild eines existierenden Gerätes. Nach Aufruf der Funktion ist dieses auf 1x1 Pixel Größe und monochromer Farbtiefe (ein Bit) festgelegt.
Bevor das kompatible DC für Zeichenoperationen genutzt werden kann, muss eine Bitmap in definierter Größe im Gerätekontext gewählt werden. Dies geschieht beispielsweise über die API-Funktion CreateCompatibleBitmap.
Hinweise
- Wenn ein kompatibler Gerätekontext erstellt wurde, so sind alle Attribute des DC auf den Standardwerten festgelegt.
- Die Funktion kann nur für Geräte genutzt werden, die Rasteroperationen unterstützen. Um herauszufinden, ob von einem Gerät ein kompatibler Gerätekontext erstellt werden kann, empfiehlt sich die Prüfung mittels GetDeviceCaps.
- Nachdem das kompatible DC nicht mehr genutzt wird, muss es mit DeleteDC gelöscht werden.
[OPTIONAL] Betriebsystem
Die Funktion ist unter folgenden Betriebssystemen funktionsfähig:
- Windows 2000
- Windows XP
- Windows Vista
- Windows Embedded CE und Windows Mobile
[OPTIONAL] Verwandte Funktionen
DeleteDC
CreateCompatibleBitmap
Verweise
- ActiveVB Tipp 0112
- ActiveVB Tipp 0114
- ActiveVB Tipp 0125
- ActiveVB Tipp 0431
- ActiveVB Tipp 0446
- ActiveVB Tipp 0470
- ActiveVB Tipp 0643
- Microsoft Knowledge-Base KB148392 - HOWTO: Capture Screens of Your Forms (ACC95, ACC97)
- Microsoft Knowledge-Base KB161299 - HOWTO: Capture and Print the Screen, a Form or a Window
- Microsoft Knowledge-Base KB186260 - HOWTO: Rotate a Bitmap Image in 90-Degree Increments
- Microsoft Knowledge-Base KB187568 - HOWTO: Create Your Own Bitmap Object Class
- Microsoft Knowledge-Base KB210108 - HOWTO: Capture Screen Shots of Your Forms (ACC2000)
- Microsoft Knowledge-Base KB260850 - HOWTO: Add a Transparent Icon to a Toolbar Button
- Microsoft Knowledge-Base KB318188 - HOWTO: Save the Client Area of a Visual Basic Form to a DIB Section
Quelle(n)
- MSDN US-Libary (http://msdn.microsoft.com/en-us/library/dd183489(VS.85).aspx).