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 |
|---|---|
|
Pinceau noir. |
|
Pinceau gris foncé. |
|
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. |
|
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 le noir. 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 à pas 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 remarques.
La police par défaut est Tahoma. |
|
Police à pas fixe (monospace) dépendante du fabricant d’équipement d’origine (OEM). |
|
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. |
|
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. |
|
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
Fonctions de contexte d’appareil