Funzione GetStockObject (wingdi.h)

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

Vedi anche

DeleteObject

Funzioni del contesto del dispositivo

Panoramica dei contesti del dispositivo

SelectObject