EM_SETRECT message

Définit le rectangle de mise en forme d’un contrôle d’édition multiligne. Le rectangle de mise en forme est le rectangle limitatif dans lequel le contrôle dessine le texte. Le rectangle de limitation est indépendant de la taille de la fenêtre de contrôle d’édition.

Ce message est traité uniquement par des contrôles d’édition multilignes. Vous pouvez envoyer ce message à un contrôle d’édition ou à un contrôle d’édition enrichi.

Paramètres

wParam

Rich Edit 2.0 et versions ultérieures : Indique si lParam spécifie des coordonnées absolues ou relatives. La valeur zéro indique les coordonnées absolues. La valeur 1 indique les décalages par rapport au rectangle de mise en forme actuel. (Les décalages peuvent être positifs ou négatifs.)

Modifier les contrôles et Rich Edit 1.0 : Ce paramètre n’est pas utilisé et doit être égal à zéro.

lParam

Pointeur vers une structure RECT qui spécifie les nouvelles dimensions du rectangle. Si ce paramètre a la valeur NULL, le rectangle de mise en forme est défini sur ses valeurs par défaut.

Valeur retournée

Ce message ne retourne pas de valeur.

Notes

L’attribution de la valeur NULL à lParam n’a aucun effet si un appareil tactile est installé ou si EM_SETRECT est envoyé à partir d’un thread sur lequel un crochet est installé (voir SetWindowsHookEx). Dans ce cas, lParam doit contenir un pointeur valide vers une structure RECT .

Le message EM_SETRECT entraîne le redessination du texte du contrôle d’édition. Pour modifier la taille du rectangle de mise en forme sans redessiner le texte, utilisez le message EM_SETRECTNP .

Lorsqu’un contrôle d’édition est créé pour la première fois, le rectangle de mise en forme est défini sur une taille par défaut. Vous pouvez utiliser le message EM_SETRECT pour agrandir ou réduire la taille du rectangle de mise en forme par-delà la fenêtre de contrôle de modification.

Si le contrôle d’édition n’a pas de barre de défilement horizontale et que le rectangle de mise en forme est défini pour être plus grand que la fenêtre de contrôle d’édition, les lignes de texte dépassant la largeur de la fenêtre de contrôle d’édition (mais plus petite que la largeur du rectangle de mise en forme) sont rognées au lieu d’être encapsulées.

Si le contrôle d’édition contient une bordure, le rectangle de mise en forme est réduit par la taille de la bordure. Si vous ajustez le rectangle retourné par un message EM_GETRECT , vous devez supprimer la taille de la bordure avant d’utiliser le rectangle avec le message EM_SETRECT .

Modification enrichie : Pris en charge dans Microsoft Rich Edit 1.0 et versions ultérieures. Le rectangle de mise en forme n’inclut pas la barre de sélection, qui est une zone non marquée à gauche de chaque paragraphe. Lorsque l’utilisateur clique dans la barre de sélection, la ligne correspondante est sélectionnée. Pour plus d’informations sur la compatibilité des versions d’édition enrichie avec les différentes versions du système, consultez À propos des contrôles d’édition enrichi.

Spécifications

Voir aussi

Référence

EM_GETRECT

EM_SETRECTNP

Autres ressources

RECT