Função DrawFocusRect (winuser.h)
A função DrawFocusRect desenha um retângulo no estilo usado para indicar que o retângulo tem o foco.
Sintaxe
BOOL DrawFocusRect(
[in] HDC hDC,
[in] const RECT *lprc
);
Parâmetros
[in] hDC
Um identificador para o contexto do dispositivo.
[in] lprc
Um ponteiro para uma estrutura RECT que especifica as coordenadas lógicas do retângulo.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero.
Comentários
DrawFocusRect funciona apenas no modo MM_TEXT.
Como DrawFocusRect é uma função XOR, chamá-la uma segunda vez com o mesmo retângulo remove o retângulo da tela.
Essa função desenha um retângulo que não pode ser rolado. Para rolar uma área que contém um retângulo desenhado por essa função, chame DrawFocusRect para remover o retângulo da tela, role a área e chame DrawFocusRect novamente para desenhar o retângulo na nova posição.
Windows XP: O retângulo de foco agora pode ser mais grosso do que 1 pixel, portanto, é mais visível para exibições de alta resolução e alta densidade e necessidades de acessibilidade. Isso é tratado pelo SPI_SETFOCUSBORDERWIDTH e SPI_SETFOCUSBORDERHEIGHT em SystemParametersInfo.
Exemplos
Para obter um exemplo, consulte "Criando uma caixa de listagem Owner-Drawn" em Usando caixas de listagem.
Requisitos
| Requisito | Valor |
|---|---|
| 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 | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Conjunto de APIs | ext-ms-win-ntuser-draw-l1-1-0 (introduzido em Windows 8) |