Funzione GetStockObject (wingdi.h)

Articolo
03/08/2023

La funzione GetStockObject recupera un handle in una delle penne di magazzino, pennelli, tipi di carattere o tavolozze.

Sintassi

HGDIOBJ GetStockObject(
  [in] int i
);

Parametri

[in] i

Tipo di oggetto stock. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
BLACK_BRUSH	Pennello nero.
DKGRAY_BRUSH	Pennello grigio scuro.
DC_BRUSH	Pennello a tinta unita. Il colore predefinito è bianco. Il colore può essere modificato usando la funzione SetDCBrushColor . Per altre informazioni, vedere la sezione Osservazioni.
GRAY_BRUSH	Pennello grigio.
HOLLOW_BRUSH	Pennello cavo (equivalente a NULL_BRUSH).
LTGRAY_BRUSH	Pennello grigio chiaro.
NULL_BRUSH	Pennello Null (equivalente a HOLLOW_BRUSH).
WHITE_BRUSH	Pennello bianco.
BLACK_PEN	Penna nera.
DC_PEN	Colore penna a tinta unita. Il colore predefinito è nero. Il colore può essere modificato usando la funzione SetDCPenColor . Per altre informazioni, vedere la sezione Osservazioni.
NULL_PEN	Penna Null. La penna Null disegna nulla.
WHITE_PEN	Penna bianca.
ANSI_FIXED_FONT	Tipo di carattere di sistema predefinito (monospace) di Windows.
ANSI_VAR_FONT	Carattere di sistema variabile di Windows (spazio proporzionale).
DEVICE_DEFAULT_FONT	Carattere dipendente dal dispositivo.
DEFAULT_GUI_FONT	Carattere predefinito per oggetti dell'interfaccia utente, ad esempio menu e finestre di dialogo. Non è consigliabile usare DEFAULT_GUI_FONT o SYSTEM_FONT per ottenere il tipo di carattere usato dai dialoghi e dalle finestre; per altre informazioni, vedere la sezione osservazioni. Il carattere predefinito è Tahoma.
OEM_FIXED_FONT	Tipo di carattere predefinito (monospace) dipendente dal produttore di apparecchiature originali (OEM).
SYSTEM_FONT	Tipo di carattere di sistema. Per impostazione predefinita, il sistema usa il tipo di carattere di sistema per disegnare menu, controlli della finestra di dialogo e testo. Non è consigliabile usare DEFAULT_GUI_FONT o SYSTEM_FONT per ottenere il tipo di carattere usato dai dialoghi e dalle finestre; per altre informazioni, vedere la sezione osservazioni. Il tipo di carattere di sistema predefinito è Tahoma.
SYSTEM_FIXED_FONT	Carattere di sistema a passo fisso (monospace). Questo oggetto stock viene fornito solo per la compatibilità con le versioni di Windows a 16 bit precedenti a 3.0.
DEFAULT_PALETTE	Tavolozza predefinita. Questa tavolozza è costituita dai colori statici nella tavolozza del sistema.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per l'oggetto logico richiesto.

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

Commenti

Non è consigliabile usare questo metodo per ottenere il tipo di carattere corrente usato dai dialoghi e dalle finestre. Usare invece la funzione SystemParametersInfo con il parametro SPI_GETNONCLIENTMETRICS per recuperare il tipo di carattere corrente. SystemParametersInfo tiene conto del tema corrente e fornisce informazioni sul tipo di carattere per didascalie, menu e dialoghi di messaggio.

Usare gli oggetti DKGRAY_BRUSH, GRAY_BRUSH e LTGRAY_BRUSH solo in finestre con gli stili CS_HREDRAW e CS_VREDRAW. L'uso di un pennello di magazzino grigio in qualsiasi altro stile di finestra può causare un errore di allineamento dei modelli di pennello dopo lo spostamento o la dimensione di una finestra. Le origini dei pennelli di magazzino non possono essere regolate.

Gli oggetti di HOLLOW_BRUSH e NULL_BRUSH sono equivalenti.

Non è necessario (ma non è dannoso) eliminare gli oggetti stock chiamando DeleteObject.

Sia DC_BRUSH che DC_PEN possono essere usati in modo interscambiabile con altri oggetti stock come BLACK_BRUSH e BLACK_PEN. Per informazioni sul recupero del colore corrente della penna o del pennello, vedere GetDCBrushColor e GetDCPenColor. Per un esempio di impostazione dei colori, vedere Impostazione del colore penna o pennello . La funzione GetStockObject con un argomento di DC_BRUSH o DC_PEN può essere usata in modo intercambiabile con le funzioni SetDCPenColor e SetDCBrushColor.

Esempio

Per un esempio, vedere Impostazione del colore penna o pennello.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll