EM_SETRECT Nachricht

Legt das Formatierungsrechteck eines mehrlineigen Bearbeitungssteuerelements fest. Das Formatierungsrechteck ist das einschränkende Rechteck, in das das Steuerelement den Text zeichnet. Das einschränkende Rechteck ist unabhängig von der Größe des Bearbeitungssteuerelementfensters.

Diese Nachricht wird nur von Mehrzeilenbearbeitungssteuerelementen verarbeitet. Sie können diese Nachricht entweder an ein Bearbeitungssteuerelement oder ein Rich-Edit-Steuerelement senden.

Parameter

wParam

Rich Edit 2.0 und höher: Gibt an , ob lParam absolute oder relative Koordinaten angibt. Der Wert 0 (null) gibt absolute Koordinaten an. Der Wert 1 gibt Offsets relativ zum aktuellen Formatierungsrechteck an. (Die Offsets können positiv oder negativ sein.)

Bearbeiten von Steuerelementen und Rich Edit 1.0: Dieser Parameter wird nicht verwendet und muss null sein.

lParam

Ein Zeiger auf eine RECT-Struktur , die die neuen Dimensionen des Rechtecks angibt. Wenn dieser Parameter NULL ist, wird das Formatierungsrechteck auf seine Standardwerte festgelegt.

Rückgabewert

Diese Meldung gibt keinen Wert zurück.

Bemerkungen

Das Festlegen von lParam auf NULL hat keine Auswirkung, wenn ein Touchgerät installiert ist oder wenn EM_SETRECT von einem Thread gesendet wird, auf dem ein Hook installiert ist (siehe SetWindowsHookEx). In diesen Fällen sollte lParam einen gültigen Zeiger auf eine RECT-Struktur enthalten.

Die EM_SETRECT Meldung bewirkt, dass der Text des Bearbeitungssteuerelements neu gezeichnet wird. Um die Größe des Formatierungsrechtecks zu ändern, ohne den Text neu zu zeichnen, verwenden Sie die EM_SETRECTNP Meldung.

Wenn ein Bearbeitungssteuerelement zum ersten Mal erstellt wird, wird das Formatierungsrechteck auf eine Standardgröße festgelegt. Sie können die EM_SETRECT Meldung verwenden, um das Formatierungsrechteck größer oder kleiner als das Bearbeitungssteuerelementfenster zu machen.

Wenn das Bearbeitungssteuerelement keine horizontale Bildlaufleiste aufweist und das Formatierungsrechteck größer als das Bearbeitungssteuerelementfenster festgelegt ist, werden Textzeilen, die die Breite des Bearbeitungssteuerelementfensters überschreiten (aber kleiner als die Breite des Formatierungsrechtecks), statt umschlossen.

Wenn das Bearbeitungssteuerelement einen Rahmen enthält, wird das Formatierungsrechteck um die Größe des Rahmens reduziert. Wenn Sie das rechteck anpassen, das von einer EM_GETRECT Nachricht zurückgegeben wird, müssen Sie die Größe des Rahmens entfernen, bevor Sie das Rechteck mit der EM_SETRECT Nachricht verwenden.

Rich Edit: Unterstützt in Microsoft Rich Edit 1.0 und höher. Das Formatierungsrechteck enthält nicht die Auswahlleiste, bei der es sich um einen nicht markierten Bereich links neben jedem Absatz handelt. Wenn der Benutzer auf die Auswahlleiste klickt, wird die entsprechende Zeile ausgewählt. Informationen zur Kompatibilität von Rich-Edit-Versionen mit den verschiedenen Systemversionen finden Sie unter Informationen zu Rich Edit-Steuerelementen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Winuser.h (windows.h einschließen)

Siehe auch

Referenz

EM_GETRECT

EM_SETRECTNP

Andere Ressourcen

RECT