Função GetStockObject (wingdi.h)

Artigo
08/27/2023

A função GetStockObject recupera um identificador para uma das canetas de estoque, pincéis, fontes ou paletas.

Sintaxe

HGDIOBJ GetStockObject(
  [in] int i
);

Parâmetros

[in] i

O tipo de objeto de estoque. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
BLACK_BRUSH	Pincel preto.
DKGRAY_BRUSH	Pincel cinza escuro.
DC_BRUSH	Pincel de cor sólida. A cor padrão é branca. A cor pode ser alterada usando a função SetDCBrushColor . Para obter mais informações, consulte a seção Comentários.
GRAY_BRUSH	Pincel cinza.
HOLLOW_BRUSH	Pincel oco (equivalente a NULL_BRUSH).
LTGRAY_BRUSH	Pincel cinza claro.
NULL_BRUSH	Pincel nulo (equivalente a HOLLOW_BRUSH).
WHITE_BRUSH	Pincel branco.
BLACK_PEN	Caneta preta.
DC_PEN	Cor da caneta sólida. A cor padrão é preto. A cor pode ser alterada usando a função SetDCPenColor . Para obter mais informações, consulte a seção Comentários.
NULL_PEN	Caneta nula. A caneta nula não desenha nada.
WHITE_PEN	Caneta branca.
ANSI_FIXED_FONT	Fonte do sistema de tom fixo (monospace) do Windows.
ANSI_VAR_FONT	Fonte do sistema de tom variável do Windows (espaço proporcional).
DEVICE_DEFAULT_FONT	Fonte dependente de dispositivo.
DEFAULT_GUI_FONT	Fonte padrão para objetos de interface do usuário, como menus e caixas de diálogo. Não é recomendável que você use DEFAULT_GUI_FONT ou SYSTEM_FONT para obter a fonte usada por caixas de diálogo e janelas; para obter mais informações, consulte a seção comentários. A fonte padrão é Tahoma.
OEM_FIXED_FONT	Fonte OEM (fabricante de equipamento original) dependente de tom fixo (monospace).
SYSTEM_FONT	Fonte do sistema. Por padrão, o sistema usa a fonte do sistema para desenhar menus, controles de caixa de diálogo e texto. Não é recomendável que você use DEFAULT_GUI_FONT ou SYSTEM_FONT para obter a fonte usada por caixas de diálogo e janelas; para obter mais informações, consulte a seção comentários. A fonte padrão do sistema é Tahoma.
SYSTEM_FIXED_FONT	Fonte do sistema de tom fixo (monospace). Esse objeto de estoque é fornecido apenas para compatibilidade com versões de 16 bits do Windows anteriores à 3.0.
DEFAULT_PALETTE	Paleta padrão. Essa paleta consiste nas cores estáticas na paleta do sistema.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um identificador para o objeto lógico solicitado.

Se a função falhar, o valor retornado será NULL.

Comentários

Não é recomendável que você empregue esse método para obter a fonte atual usada por caixas de diálogo e janelas. Em vez disso, use a função SystemParametersInfo com o parâmetro SPI_GETNONCLIENTMETRICS para recuperar a fonte atual. SystemParametersInfo levará em conta o tema atual e fornece informações de fonte para legendas, menus e caixas de diálogo de mensagens.

Use os objetos de estoque DKGRAY_BRUSH, GRAY_BRUSH e LTGRAY_BRUSH somente em janelas com os estilos CS_HREDRAW e CS_VREDRAW. Usar um pincel de estoque cinza em qualquer outro estilo de janela pode levar ao desalinhamento de padrões de pincel depois que uma janela é movida ou dimensionada. As origens dos pincéis de estoque não podem ser ajustadas.

Os objetos de estoque HOLLOW_BRUSH e NULL_BRUSH são equivalentes.

Não é necessário (mas não é prejudicial) excluir objetos de estoque chamando DeleteObject.

Tanto DC_BRUSH quanto DC_PEN podem ser usados de forma intercambiável com outros objetos de estoque, como BLACK_BRUSH e BLACK_PEN. Para obter informações sobre como recuperar a caneta ou a cor do pincel atual, consulte GetDCBrushColor e GetDCPenColor. Consulte Definindo a caneta ou a cor do pincel para obter um exemplo de configuração de cores. A função GetStockObject com um argumento de DC_BRUSH ou DC_PEN pode ser usada de forma intercambiável com as funções SetDCPenColor e SetDCBrushColor .

Exemplos

Para obter um exemplo, consulte Definindo a caneta ou a cor do pincel.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h (inclua Windows.h)
Biblioteca	Gdi32.lib
DLL	Gdi32.dll