Partager via


GetStockObject, fonction (wingdi.h)

La fonction GetStockObject récupère une poignée dans l’un des stylets, pinceaux, polices ou palettes de stock.

Syntaxe

HGDIOBJ GetStockObject(
  [in] int i
);

Paramètres

[in] i

Type d’objet stock. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
BLACK_BRUSH
Pinceau noir.
DKGRAY_BRUSH
Pinceau gris foncé.
DC_BRUSH
Pinceau de couleur unie. La couleur par défaut est le blanc. La couleur peut être modifiée à l’aide de la fonction SetDCBrushColor . Pour plus d'informations, consultez la section Notes.
GRAY_BRUSH
Pinceau gris.
HOLLOW_BRUSH
Pinceau creux (équivalent à NULL_BRUSH).
LTGRAY_BRUSH
Pinceau gris clair.
NULL_BRUSH
Pinceau Null (équivalent à HOLLOW_BRUSH).
WHITE_BRUSH
Pinceau blanc.
BLACK_PEN
Stylet noir.
DC_PEN
Couleur de stylet unie. La couleur par défaut est le noir. La couleur peut être modifiée à l’aide de la fonction SetDCPenColor . Pour plus d'informations, consultez la section Notes.
NULL_PEN
Stylet Null. Le stylet null ne dessine rien.
WHITE_PEN
Stylet blanc.
ANSI_FIXED_FONT
Police système windows à pas fixe (monospace).
ANSI_VAR_FONT
Police système à pas variable (espace proportionnel) Windows.
DEVICE_DEFAULT_FONT
Police dépendante de l’appareil.
DEFAULT_GUI_FONT
Police par défaut pour les objets d’interface utilisateur tels que les menus et les boîtes de dialogue. Il n’est pas recommandé d’utiliser DEFAULT_GUI_FONT ou SYSTEM_FONT pour obtenir la police utilisée par les boîtes de dialogue et les fenêtres ; Pour plus d’informations, consultez la section remarques.

La police par défaut est Tahoma.

OEM_FIXED_FONT
Police à pas fixe (monospace) dépendante du fabricant d’équipement d’origine (OEM).
SYSTEM_FONT
Police système. Par défaut, le système utilise la police système pour dessiner des menus, des contrôles de boîte de dialogue et du texte. Il n’est pas recommandé d’utiliser DEFAULT_GUI_FONT ou SYSTEM_FONT pour obtenir la police utilisée par les boîtes de dialogue et les fenêtres ; Pour plus d’informations, consultez la section remarques.

La police système par défaut est Tahoma.

SYSTEM_FIXED_FONT
Police système à pas fixe (monospace). Cet objet stock est fourni uniquement à des fins de compatibilité avec les versions 16 bits de Windows antérieures à 3.0.
DEFAULT_PALETTE
Palette par défaut. Cette palette se compose des couleurs statiques de la palette système.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle de l’objet logique demandé.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

Il n’est pas recommandé d’utiliser cette méthode pour obtenir la police actuelle utilisée par les boîtes de dialogue et les fenêtres. Utilisez plutôt la fonction SystemParametersInfo avec le paramètre SPI_GETNONCLIENTMETRICS pour récupérer la police actuelle. SystemParametersInfo prend en compte le thème actuel et fournit des informations de police pour les légendes, les menus et les boîtes de dialogue de message.

Utilisez les objets stock DKGRAY_BRUSH, GRAY_BRUSH et LTGRAY_BRUSH uniquement dans les fenêtres avec les styles CS_HREDRAW et CS_VREDRAW. L’utilisation d’un pinceau gris dans n’importe quel autre style de fenêtre peut entraîner un mauvais alignement des modèles de pinceau après le déplacement ou la dimensionnement d’une fenêtre. Les origines des brosses de stock ne peuvent pas être ajustées.

Les objets HOLLOW_BRUSH et NULL_BRUSH stock sont équivalents.

Il n’est pas nécessaire (mais ce n’est pas dangereux) de supprimer des objets stock en appelant DeleteObject.

Les DC_BRUSH et les DC_PEN peuvent être utilisés indifféremment avec d’autres objets de stock tels que BLACK_BRUSH et BLACK_PEN. Pour plus d’informations sur la récupération de la couleur actuelle du stylet ou du pinceau, consultez GetDCBrushColor et GetDCPenColor. Pour obtenir un exemple de définition des couleurs , consultez Définition du stylet ou de la couleur du pinceau. La fonction GetStockObject avec un argument DC_BRUSH ou DC_PEN peut être utilisée indifféremment avec les fonctions SetDCPenColor et SetDCBrushColor .

Exemples

Pour obtenir un exemple, consultez Définition de la couleur du stylet ou du pinceau.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

DeleteObject

Fonctions de contexte d’appareil

Vue d’ensemble des contextes d’appareil

SélectionnerObject