Función GetStockObject (wingdi.h)
La función GetStockObject recupera un identificador de uno de los lápices, pinceles, fuentes o paletas de stock.
Sintaxis
HGDIOBJ GetStockObject(
[in] int i
);
Parámetros
[in] i
Tipo de objeto stock. Este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
: pincel negro. |
|
: pincel gris oscuro. |
|
Pincel de color sólido. El color predeterminado es blanco. El color se puede cambiar mediante la función SetDCBrushColor . Para obtener más información, vea la sección Comentarios. |
|
: pincel gris. |
|
Pincel hueco (equivalente a NULL_BRUSH). |
|
: pincel gris claro. |
|
Pincel nulo (equivalente a HOLLOW_BRUSH). |
|
: pincel blanco. |
|
: lápiz negro. |
|
Color de lápiz sólido. El color predeterminado es negro. El color se puede cambiar mediante la función SetDCPenColor . Para obtener más información, vea la sección Comentarios. |
|
: lápiz nulo. El lápiz null no dibuja nada. |
|
: lápiz blanco. |
|
Fuente del sistema de inclinación fija (monoespacio) de Windows. |
|
Fuente del sistema de inclinación variable (espacio proporcional) de Windows. |
|
: fuente dependiente del dispositivo. |
|
Fuente predeterminada para objetos de interfaz de usuario, como menús y cuadros de diálogo. No se recomienda usar DEFAULT_GUI_FONT o SYSTEM_FONT para obtener la fuente utilizada por cuadros de diálogo y ventanas; para obtener más información, vea la sección comentarios.
La fuente predeterminada es Tahoma. |
|
Fuente dependiente del fabricante de equipos originales (OEM) de tono fijo (monoespacio). |
|
Fuente del sistema. De forma predeterminada, el sistema usa la fuente del sistema para dibujar menús, controles de cuadro de diálogo y texto. No se recomienda usar DEFAULT_GUI_FONT o SYSTEM_FONT para obtener la fuente utilizada por cuadros de diálogo y ventanas; para obtener más información, vea la sección comentarios.
La fuente predeterminada del sistema es Tahoma. |
|
Fuente del sistema de tono fijo (monospace). Este objeto stock solo se proporciona por compatibilidad con versiones de Windows de 16 bits anteriores a 3.0. |
|
Paleta predeterminada. Esta paleta consta de los colores estáticos de la paleta del sistema. |
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un identificador para el objeto lógico solicitado.
Si la función no se realiza correctamente, el valor devuelto es NULL.
Comentarios
No se recomienda emplear este método para obtener la fuente actual utilizada por cuadros de diálogo y ventanas. En su lugar, use la función SystemParametersInfo con el parámetro SPI_GETNONCLIENTMETRICS para recuperar la fuente actual. SystemParametersInfo tendrá en cuenta el tema actual y proporciona información de fuente para títulos, menús y diálogos de mensajes.
Use los objetos DKGRAY_BRUSH, GRAY_BRUSH y LTGRAY_BRUSH stock solo en ventanas con los estilos CS_HREDRAW y CS_VREDRAW. El uso de un pincel gris en cualquier otro estilo de ventana puede dar lugar a una desalineación de patrones de pincel después de mover o ajustar el tamaño de una ventana. No se pueden ajustar los orígenes de los pinceles de stock.
Los objetos HOLLOW_BRUSH y NULL_BRUSH stock son equivalentes.
No es necesario (pero no es perjudicial) eliminar objetos de stock llamando a DeleteObject.
Tanto DC_BRUSH como DC_PEN se pueden usar indistintamente con otros objetos de stock como BLACK_BRUSH y BLACK_PEN. Para obtener información sobre cómo recuperar el color actual del lápiz o pincel, vea GetDCBrushColor y GetDCPenColor. Vea Establecer el lápiz o el color del pincel para obtener un ejemplo de cómo establecer colores. La función GetStockObject con un argumento de DC_BRUSH o DC_PEN se puede usar indistintamente con las funciones SetDCPenColor y SetDCBrushColor .
Ejemplos
Para obtener un ejemplo, vea Establecer el lápiz o el color del pincel.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wingdi.h (incluye Windows.h) |
| Library | Gdi32.lib |
| Archivo DLL | Gdi32.dll |
Consulte también
Funciones de contexto de dispositivo