Funzione GetObjectA (wingdi.h)

Articolo
11/20/2024

La funzione GetObject recupera informazioni per l'oggetto grafico specificato.

Sintassi

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

Parametri

h

c

pv

Valore restituito

Se la funzione ha esito positivo e lpvObject è un puntatore valido, il valore restituito corrisponde al numero di byte archiviati nel buffer.

Se la funzione ha esito positivo e lpvObject è NULL, il valore restituito è il numero di byte necessari per contenere le informazioni che la funzione archivierebbe nel buffer.

Se la funzione ha esito negativo, il valore restituito è zero.

Osservazioni

Il buffer a cui punta il parametro lpvObject deve essere sufficientemente grande per ricevere le informazioni sull'oggetto grafico. A seconda dell'oggetto grafico, la funzione usa un BITMAP, DIBSECTION, EXTLOGPEN, LOGBRUSH, LOGFONTo LOGPEN struttura o un conteggio delle voci di tabella (per una tavolozza logica).

Se hgdiobj è un handle per una bitmap creata chiamando CreateDIBSectione il buffer specificato è sufficientemente grande, la funzione GetObject restituisce una struttura di DIBSECTION. Inoltre, il bmBits membro della struttura BITMAP contenuta all'interno del DIBSECTION conterrà un puntatore ai valori di bit della bitmap.

Se hgdiobj è un handle per una bitmap creata da qualsiasi altro mezzo, GetObject restituisce solo le informazioni sul formato di larghezza, altezza e colore della bitmap. È possibile ottenere i valori di bit della bitmap chiamando il GetDIBits o funzione GetBitmapBits.

Se hgdiobj è un handle per una tavolozza logica, GetObject recupera un numero intero a 2 byte che specifica il numero di voci nella tavolozza. La funzione non recupera la struttura LOGPALETTE che definisce la tavolozza. Per recuperare informazioni sulle voci del riquadro, un'applicazione può chiamare la funzione GetPaletteEntries.

Se hgdiobj è un handle per un tipo di carattere, il LOGFONT restituito è il LOGFONT utilizzato per creare il tipo di carattere. Se Windows deve eseguire un'interpolazione del tipo di carattere perché non è stato possibile rappresentare il LOGFONT preciso , l'interpolazione non verrà riflessa nell'LOGFONT. Ad esempio, se si richiede una versione verticale di un tipo di carattere che non supporta il disegno verticale, il LOGFONT indica che il tipo di carattere è verticale, ma Windows lo dipingerà orizzontalmente.

Esempi

Per un esempio, vedere Archiviazione di un'immagine.

Nota

L'intestazione wingdi.h definisce GetObject come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wingdi.h (include Windows.h)
libreria	Gdi32.lib
dll	Gdi32.dll