Función GetStockObject (wingdi.h)

  • Artículo

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
BLACK_BRUSH
 : pincel negro.
DKGRAY_BRUSH
 : pincel gris oscuro.
DC_BRUSH
 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.
GRAY_BRUSH
 : pincel gris.
HOLLOW_BRUSH
 Pincel hueco (equivalente a NULL_BRUSH).
LTGRAY_BRUSH
 : pincel gris claro.
NULL_BRUSH
 Pincel nulo (equivalente a HOLLOW_BRUSH).
WHITE_BRUSH
 : pincel blanco.
BLACK_PEN
 : lápiz negro.
DC_PEN
 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.
NULL_PEN
 : lápiz nulo. El lápiz null no dibuja nada.
WHITE_PEN
 : lápiz blanco.
ANSI_FIXED_FONT
 Fuente del sistema de inclinación fija (monoespacio) de Windows.
ANSI_VAR_FONT
 Fuente del sistema de inclinación variable (espacio proporcional) de Windows.
DEVICE_DEFAULT_FONT
 : fuente dependiente del dispositivo.
DEFAULT_GUI_FONT
 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.
OEM_FIXED_FONT
 Fuente dependiente del fabricante de equipos originales (OEM) de tono fijo (monoespacio).
SYSTEM_FONT
 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.
SYSTEM_FIXED_FONT
 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.
DEFAULT_PALETTE
 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

DeleteObject

Funciones de contexto de dispositivo

Información general sobre contextos de dispositivo

SelectObject