Compartilhar via


Função GetStockObject (wingdi.h)

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

Confira também

DeleteObject

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

Selectobject