GetObjectA-Funktion (wingdi.h)

Artikel
03/06/2024

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

Syntax

int GetObjectA(
        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 lpvObjectNULL ist, ist der Rückgabewert die Anzahl der Bytes, die erforderlich sind, um die Informationen zu speichern, die die Funktion im Puffer speichern würde.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Hinweise

Der Puffer, auf den der lpvObject-Parameter verweist, muss ausreichend groß sein, um die Informationen zum Grafikobjekt zu empfangen. Abhängig vom Grafikobjekt verwendet die Funktion eine BITMAP-, DIBSECTION-, EXTLOGPEN-, LOGBRUSH-, LOGFONT- oder 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 von CreateDIBSection erstellt wurde, und der angegebene Puffer groß genug ist, gibt die GetObject-Funktion eine DIBSECTION-Struktur zurück. Darüber hinaus enthält das bmBits-Element 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 wurde, 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 Funktion GetDIBits oder GetBitmapBits 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 das zurückgegebene LOGFONT das LOGFONT , das zum Erstellen der Schriftart verwendet wird. Wenn Windows eine Interpolation der Schriftart vornehmen musste, weil das genaue LOGFONT nicht dargestellt werden konnte, wird die Interpolation nicht im LOGFONT widergespiegelt. Wenn Sie z. B. nach einer vertikalen Version einer Schriftart fragen, die vertikales Zeichnen nicht unterstützt, gibt LOGFONT an, dass die Schriftart vertikal ist, windows sie jedoch horizontal zeichnet.

Beispiele

Ein Beispiel finden Sie unter Speichern eines Images.

Hinweis

Der wingdi.h-Header definiert GetObject als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll