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 |
|---|---|
|
Pincel preto. |
|
Pincel cinza escuro. |
|
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. |
|
Pincel cinza. |
|
Pincel oco (equivalente a NULL_BRUSH). |
|
Pincel cinza claro. |
|
Pincel nulo (equivalente a HOLLOW_BRUSH). |
|
Pincel branco. |
|
Caneta preta. |
|
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. |
|
Caneta nula. A caneta nula não desenha nada. |
|
Caneta branca. |
|
Fonte do sistema de tom fixo (monospace) do Windows. |
|
Fonte do sistema de tom variável do Windows (espaço proporcional). |
|
Fonte dependente de dispositivo. |
|
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. |
|
Fonte OEM (fabricante de equipamento original) dependente de tom fixo (monospace). |
|
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. |
|
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. |
|
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
Funções de contexto do dispositivo