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 |
|---|---|
|
Pennello nero. |
|
Pennello grigio scuro. |
|
Pennello a tinta unita. Il colore predefinito è bianco. Il colore può essere modificato usando la funzione SetDCBrushColor . Per altre informazioni, vedere la sezione Osservazioni. |
|
Pennello grigio. |
|
Pennello cavo (equivalente a NULL_BRUSH). |
|
Pennello grigio chiaro. |
|
Pennello Null (equivalente a HOLLOW_BRUSH). |
|
Pennello bianco. |
|
Penna nera. |
|
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. |
|
Penna Null. La penna Null disegna nulla. |
|
Penna bianca. |
|
Tipo di carattere di sistema predefinito (monospace) di Windows. |
|
Carattere di sistema variabile di Windows (spazio proporzionale). |
|
Carattere dipendente dal dispositivo. |
|
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. |
|
Tipo di carattere predefinito (monospace) dipendente dal produttore di apparecchiature originali (OEM). |
|
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. |
|
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. |
|
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
Funzioni del contesto del dispositivo