GetObject

von ActiveVB-Team

Deklaration

Declare Function GetObject Lib "gdi32" _
                 Alias "GetObjectA" ( _
                 ByVal hObject As Long, _
                 ByVal nCount As Long, _
                 lpObject As Any) As Long

Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel GetObject des API-Wikis.

GetObject gibt die Informationen über eine Bitmap, eine Palette, einen logischen Stift, einen Pinsel, eine Font oder einen DIB-Abschnitt zurück.

Parameter
hObject	Gibt das Handle eines GDI-Objektes zurück. Das sollte das Handle einer logischen Bitmap sein, eines DIB-Bereiches (erzeugt mit CreateDIBSection), eines Stiftes, einer Palette, eines Pinsels oder einer Font sein.
nCount	Die Größe des Puffers auf den lpObject zeigt, angegeben in Bytes.
lpObject	Ein Zeiger auf einen Puffer. Die zurückgegebenen Daten sind von hObject abhängig. Weitere Information finden sie in dieser Tabelle .

Tabelle 1

Datentypen für GetObject
Logische Bitmap	Der Puffer enthält nur eine BITMAP Struktur. Nur die Informationen für Höhe, Breite und Farbformat sind gültig.
DIB-Abschnitt	Der Puffer enthält eine DIBSECTION Struktur
Logischer Stift	Der Puffer enthält eine EXTLOGPEN oder eine LOGPEN Struktur, abhängig vom Stiftyp.
Logischer Pinsel	Der Puffer enthält eine LOGBRUSH Struktur
Logische Font	Der Puffer enthält eine LOGFONT Struktur
Palette	Der Puffer enhält eine WORD Struktur, die die Anzahl der Paletteneinträge angibt, die innerhalb der Palette existieren. Diese Werte können mit GetSystemPaletteEntries ermittelt werden

Tabelle 2

Rückgabewerte
x	War die Funktion erfolgreich, wird die Anzahl der Bytes zurückgegeben, die in den Puffer kopiert wurden. Wenn lpObject gleich Null ist, wird die erforderliche Puffergröße zurückgegeben.
0	Es trat ein Fehler auf.

Tabelle 3

Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
CreateDIBSection, GetBitmapBits, GetDIBits, GetPaletteEntries, GetRegionData

Zugehörige Tipps

8-Bit-Bitmaps drehen, rotieren [Tipp 0222]
24-Bit-Bitmaps rotieren und zoomen [Tipp 0223]
VB-Blur Demo [Tipp 0243]
Helligkeit und Kontrast einer 24-Bit Bitmap ändern [Tipp 0253]
Emboss-Effekt auf eine 24-Bit-Bitmap anwenden [Tipp 0254]
RGB-Farbanteile einer 24-Bit-Bitmap manipulieren [Tipp 0255]
Ripple-Effekt auf eine 24-Bit-Bitmap anwenden [Tipp 0256]
Optisches Schärfen einer 24-Bit-Bitmap [Tipp 0257]
Schnelle grafische Operationen Get- und SetBitmap [Tipp 0432]
Bitmaps in verschiedenen Farbtiefen speichern [Tipp 0493]
Veränderung von Bitmaps durch Manipulation der Farbpalette [Tipp 0509]
Farbtiefe einer Bitmap ändern [Tipp 0517]
Bitmap in einen String umwandeln [Tipp 0556]
Ein Bild mithilfe von ASM drehen [Tipp 0618]
Helligkeitsänderung in Grafiken per ASM [Tipp 0626]
Grundfarbe, Sättigung und Helligkeit in Grafiken ändern per ASM [Tipp 0627]
Änderung der RGB-Werte einer Grafik per ASM [Tipp 0628]
Embosseffekte auf Grafiken per ASM anwenden [Tipp 0629]
Grafik in Grautönen zeichnen per ASM [Tipp 0630]
Grafik invertieren per ASM [Tipp 0631]
Kontrast einer Grafik ändern per ASM [Tipp 0632]
Monochrom Grafik erzeugen per ASM [Tipp 0633]
Neoneffekte auf eine Grafik anwenden per ASM [Tipp 0634]
Grafiken ein- und ausblenden per ASM [Tipp 0635]
Grafik schattieren per ASM [Tipp 0642]
Farbtiefe einer PictureBox verändern [Tipp 0643]
Bitmaps drehen per ASM [Tipp 0653]
Farbtiefe einer Bitmap mittels GDI+ ändern [Tipp 0685]
Grafik mittels GDI+ als TIFF speichern [Tipp 0688]
Farbtiefe einer Bitmap ändern und in verschiedenen Farbtiefen speichern [Tipp 0700]
Bilder mit Toleranz vergleichen [Tipp 0723]
Blueboxing [Tipp 0724]

Zugehörige Microsoft Knowledge Base Artikel