Fonction DrawFocusRect (winuser.h)

  • Article

La fonction DrawFocusRect dessine un rectangle dans le style utilisé pour indiquer que le rectangle a le focus.

Syntaxe

BOOL DrawFocusRect(
  [in] HDC        hDC,
  [in] const RECT *lprc
);

Paramètres

[in] hDC

Handle dans le contexte de l’appareil.

[in] lprc

Pointeur vers une structure RECT qui spécifie les coordonnées logiques du rectangle.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

DrawFocusRect fonctionne uniquement en mode MM_TEXT.

Étant donné que DrawFocusRect est une fonction XOR, l’appeler une deuxième fois avec le même rectangle supprime le rectangle de l’écran.

Cette fonction dessine un rectangle qui ne peut pas être fait défiler. Pour faire défiler une zone contenant un rectangle dessiné par cette fonction, appelez DrawFocusRect pour supprimer le rectangle de l’écran, faites défiler la zone, puis appelez à nouveau DrawFocusRect pour dessiner le rectangle dans la nouvelle position.

Windows XP : Le rectangle de mise au point peut désormais être plus épais que 1 pixel, il est donc plus visible pour les affichages haute résolution et les besoins d’accessibilité. Cela est géré par le SPI_SETFOCUSBORDERWIDTH et SPI_SETFOCUSBORDERHEIGHT dans SystemParametersInfo.

Exemples

Pour obtenir un exemple, consultez « Création d’une zone de liste Owner-Drawn » dans Utilisation de zones de liste.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-draw-l1-1-0 (introduit dans Windows 8)

Voir aussi

FrameRect

Fonctions de peinture et de dessin

Vue d’ensemble de la peinture et du dessin

RECT