EM _ SETRECT-Nachricht
Legt das Formatierungsrechteck eines mehrzweckigen Bearbeitungssteuer steuerelements 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 Bearbeitungssteuerfensters.
Diese Meldung wird nur von mehrline-Bearbeitungssteuerelementen verarbeitet. Sie können diese Nachricht entweder an ein Bearbeitungssteuer steuerelement oder an 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.)
Steuerelemente bearbeiten und Rich Edit 1.0: Dieser Parameter wird nicht verwendet und muss 0 (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.
Hinweise
Das Festlegen von lParam auf NULL hat keine Auswirkungen, wenn ein Touchgerät installiert ist oder 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 Bearbeitungssteuerfelds 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 Bearbeitungssteuer steuerelement zum ersten Mal erstellt wird, wird das Formatierungrechteck auf eine Standardgröße festgelegt. Sie können die EM _ SETRECT-Meldung verwenden, um das Formatierungrechteck größer oder kleiner als das Bearbeitungssteuerfenster zu machen.
Wenn das Bearbeitungssteuerfeld nicht über eine horizontale Bildlaufleiste verfügt und das Formatierungsrechteck größer als das Bearbeitungssteuersteuerfenster ist, werden Textzeilen, die die Breite des Bearbeitungssteuersteuerfensters überschreiten (aber kleiner als die Breite des Formatierungsrechtecks sind), abgeschnitten und nicht umschlossen.
Wenn das Bearbeitungssteuer steuerelement einen Rahmen enthält, wird das Formatierungrechteck 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.
Umfangreiche Bearbeitung: Wird in Microsoft Rich Edit 1.0 und höher unterstützt. Das Formatierungrechteck enthält nicht die Auswahlleiste, bei der es sich um einen nicht markierten Bereich links von 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 Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Header |
|
Siehe auch
-
Referenz
-
Andere Ressourcen