GetObjectW-Funktion (wingdi.h)

Artikel
11/20/2024

Die GetObject-Funktion ruft Informationen für das angegebene Grafikobjekt ab.

Syntax

int GetObjectW(
        HANDLE h,
        int    c,
        LPVOID pv
);

Parameter

h

c

pv

Rückgabewert

Wenn die Funktion erfolgreich ist und lpvObject ein gültiger Zeiger ist, ist der Rückgabewert die Anzahl der im Puffer gespeicherten Bytes.

Wenn die Funktion erfolgreich ist und lpvObject-NULL-ist, ist der Rückgabewert die Anzahl der Bytes, die zum Speichern der Informationen erforderlich sind, die die Funktion im Puffer speichern würde.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null.

Bemerkungen

Der Puffer, auf den der lpvObject--Parameter verweist, muss ausreichend groß sein, um die Informationen zum Grafikobjekt zu erhalten. Je nach Grafikobjekt verwendet die Funktion ein BITMAP-, DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONToder LOGPEN Struktur oder eine Anzahl von Tabelleneinträgen (für eine logische Palette).

Wenn hgdiobj- ein Handle für eine Bitmap ist, die durch Aufrufen CreateDIBSection-erstellt wird und der angegebene Puffer groß genug ist, gibt die GetObject--Funktion eine DIBSECTION- Struktur zurück. Darüber hinaus enthält das bmBits Member der BITMAP- Struktur, die in der DIBSECTION- enthalten ist, einen Zeiger auf die Bitwerte der Bitmap.

Wenn hgdiobj ein Handle für eine Bitmap ist, die auf andere Weise erstellt wird, gibt GetObject- nur die Informationen zu Breite, Höhe und Farbformat der Bitmap zurück. Sie können die Bitwerte der Bitmap abrufen, indem Sie die GetDIBits-- oder GetBitmapBits-Funktion aufrufen.

Wenn hgdiobj ein Handle für eine logische Palette ist, ruft GetObject eine 2-Byte-Ganzzahl ab, die die Anzahl der Einträge in der Palette angibt. Die Funktion ruft nicht die LOGPALETTE Struktur ab, die die Palette definiert. Um Informationen zu Paletteneinträgen abzurufen, kann eine Anwendung die GetPaletteEntries-Funktion aufrufen.

Wenn hgdiobj ein Handle für eine Schriftart ist, ist die zurückgegebene LOGFONT- die LOGFONT-, die zum Erstellen der Schriftart verwendet wird. Wenn Windows eine Interpolation der Schriftart vornehmen musste, da das genaue LOGFONT- nicht dargestellt werden konnte, wird die Interpolation nicht in der LOGFONT-angezeigt. Wenn Sie z. B. nach einer vertikalen Version einer Schriftart fragen, die das vertikale Malen nicht unterstützt, gibt die LOGFONT- an, dass die Schriftart vertikal ist, aber Windows zeichnet sie horizontal.

Beispiele

Ein Beispiel finden Sie unter Speichern eines Bilds.

Anmerkung

Der wingdi.h-Header definiert GetObject als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wingdi.h (enthalten Windows.h)
Library	Gdi32.lib
DLL-	Gdi32.dll