FrameRect, fonction (winuser.h)

Article
08/27/2023

La fonction FrameRect dessine une bordure autour du rectangle spécifié à l’aide du pinceau spécifié. La largeur et la hauteur de la bordure sont toujours une unité logique.

Syntaxe

int FrameRect(
  [in] HDC        hDC,
  [in] const RECT *lprc,
  [in] HBRUSH     hbr
);

Paramètres

[in] hDC

Handle du contexte de l’appareil dans lequel la bordure est dessinée.

[in] lprc

Pointeur vers une structure RECT qui contient les coordonnées logiques des coins supérieur gauche et inférieur droit du rectangle.

[in] hbr

Poignée au pinceau utilisé pour dessiner la bordure.

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

Le pinceau identifié par le paramètre hbr doit avoir été créé à l’aide de la fonction CreateHatchBrush, CreatePatternBrush ou CreateSolidBrush , ou récupéré à l’aide de la fonction GetStockObject .

Si le membre inférieur de la structure RECT est inférieur au membre supérieur , ou si le membre droit est inférieur au membre gauche , la fonction ne dessine pas le rectangle.

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-gui-l1-1-1 (introduit dans Windows 8.1)