GetStockObject, fonction (wingdi.h)
La fonction GetStockObject récupère un handle dans l’un des stylos stock, pinceaux, polices ou palettes.
Syntaxe
HGDIOBJ GetStockObject(
[in] int i
);
Paramètres
[in] i
Type d’objet stock. Ce paramètre peut prendre les valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Pinceau noir. |
|
Pinceau gris foncé. |
|
Pinceau de couleur unie. La couleur par défaut est blanche. La couleur peut être modifiée à l’aide de la fonction SetDCBrushColor . Pour plus d'informations, consultez la section Notes. |
|
Pinceau gris. |
|
Pinceau creux (équivalent à NULL_BRUSH). |
|
Pinceau gris clair. |
|
Pinceau Null (équivalent à HOLLOW_BRUSH). |
|
Pinceau blanc. |
|
Stylet noir. |
|
Couleur de stylet unie. La couleur par défaut est noire. La couleur peut être modifiée à l’aide de la fonction SetDCPenColor . Pour plus d'informations, consultez la section Notes. |
|
Stylet Null. Le stylet Null ne dessine rien. |
|
Stylet blanc. |
|
Police système windows à pas fixe (monospace). |
|
Police système de tangage variable (espace proportionnel) Windows. |
|
Police dépendante de l’appareil. |
|
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 notes.
La police par défaut est Tahoma. |
|
Police du fabricant d’équipement d’origine (OEM) dépendante de la hauteur fixe (monospace). |
|
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 notes.
La police système par défaut est Tahoma. |
|
Police système à tangage fixe (monospace). Cet objet stock est fourni uniquement pour la compatibilité avec les versions 16 bits de Windows antérieures à 3.0. |
|
Palette par défaut. Cette palette se compose des couleurs statiques dans 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.
Notes
Il n’est pas recommandé d’utiliser cette méthode pour obtenir la police actuelle utilisée par les dialogues 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 des messages.
Utilisez les objets DKGRAY_BRUSH, GRAY_BRUSH et LTGRAY_BRUSH stock uniquement dans les fenêtres avec les styles CS_HREDRAW et CS_VREDRAW. L’utilisation d’un pinceau de stock gris dans n’importe quel autre style de fenêtre peut entraîner une mauvaise alignement des motifs de pinceau après le déplacement ou la taille d’une fenêtre. Les origines des pinceaux 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 il n’est pas dangereux) de supprimer des objets boursiers en appelant DeleteObject.
Les DC_BRUSH et les DC_PEN peuvent être utilisés indifféremment avec d’autres objets boursiers 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. Consultez Définition de la couleur du stylet ou du pinceau pour obtenir un exemple de définition de couleurs. La fonction GetStockObject avec un argument de DC_BRUSH ou de DC_PEN peut être utilisée de manière interchangeable 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 (include Windows.h) |
| Bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |
Voir aussi
Fonctions de contexte d’appareil