¶ Beschreibung
RichTextBox = Textfeld mit Textformatierung
Eine RichTextBox wird verwendet, wenn formatierter Text ausgegeben, eingegeben bzw. gespeichert werden soll. Für die Textformatierung wird die bereitgestellte Werkzeugpalette genutzt.
¶ RichTextBox für Designer
Zur Textformatierung mit dem Control RichTextBox steht im FormDesigner nebenstehende Werkzeugpalette zur Verfügung.
¶ Eigenschaften
| Eigenschaft | Erklärung |
|---|---|
| Entwurf | |
| HideBackColorItem | Mit True wird die Schaltfläche zur Bearbeitung der Texthintergrundfarbe in der Werkzeugleiste (Toolbar) im FormDesigner genauso wie im FormViewer für Windows-Formulare ausgeblendet. Verfügbar ab Maskito 7.1 |
| ShowToolBar | Mit True wird dem Anwender eine Werkzeugpalette zur Textformatierung zur Verfügung gestellt. |
| Autosize | Mit True wächst das Textfeld nach unten bis zu dem Wert, der als MaxHeight definiert ist, falls mehr Text eingegeben wird, als das Textfeld aufnehmen kann. Die MaxHeight sollte nicht kleiner als die Höhe sein, die als Size-Eigenschaft definiert wird. Der Wert True geeignet für Boxen, die recht weit am unteren Rand eines Formulars positioniert sind. Hinweis: Der Punkt "MultiLine" muss auf einem Wert "True" stehen. |
| MaxHeight | Definiert die maximale Höhe für das Control in Pixel. Die MaxHeight sollte nicht kleiner als die individuell definierte Höhe in der Size-Eigenschaft sein. Hinweis: Wird erst wirksam wenn "Autosize" den Wert "True" hat. |
| MaxLength | Definiert die maximale Anzahl von Zeichen, die im Control eingegeben werden können. |
| MultiLine | Definiert, ob das Control mehr als eine Zeile Text enthalten darf (verfügbar bis Maskito 7.2. Danach entfällt diese Eigenschaft, da das Control grundsätzlich die Eingabe mehrzeiliger Medien erlaubt, z. B. Bilder, Tabellen etc.). |
| ReadOnly (bis Formularware 3.0 SP I = OnlyRead) | Gibt an, ob der Text im Control nur gelesen oder auch geändert werden kann. Bei True können Anwender den Text lesen, aber nicht mehr verändern. |
| PlainTextXMLOutput | Gibt für Windows-Formulare an, ob die Daten in .sfx/.xml-Dateien als reiner Text ausgegeben werden sollen. True = Textformatierung beim Speichern verwerfen False = Textformatierung als RTF speichern Hinweis: Die Kodierung der Datensätze in RTF kann im Nachhinein nicht mehr verändert werden. Bei Web-Formularen werden die Eingaben in RichTextBoxen generell in HTML5 sowie unformatiert in der Datenbank gespeichert. |
| Scrollbars | Definiert die Sichtbarkeit der Scroll-Balken für das Control. |
| TextAlign | Definiert die Vorformatierung der Textausrichtung im Control. |
| Accepts Tabs | Definiert, ob Tabulatorzeichen als Eingabe für mehrzeilige Bearbeitungssteuerelemente akzeptiert werden. |
| DectectUrls | Definiert, ob Hyperlinks automatisch blau hervorgehoben werden sollen. |
| WordWrap | Definiert, ob Textinhalt automatisch umgebrochen werden soll. |
¶ Funktionen
| Eigenschaft | Erklärung |
|---|---|
| Text | Dem Control kann ein "PlainText" zugewiesen werden. "PlainText" = Text ohne Textformatierung |
| rtf | Dem Control kann ein formatierter Text (rtf) zugewiesen werden. |
| ReadOnly | Gibt an, ob der Text im Control nur gelesen oder auch geändert werden kann. Bei True können Anwender den Text lesen, aber nicht mehr verändern. |
| BackColor | Dem Control kann eine Hintergrundfarbe zugewiesen werden. |
| ForeColor | Dem Control kann eine Schriftfarbe zugewiesen werden. |
| xmloutput | Mit True können die Eingabedaten in der .sfx/.xml-Datei gespeichert werden. |
| OnEnter | Eine Reaktion definieren, wenn der Fokus während der Bearbeitung auf das Control gesetzt wird. |
| OnLeave | Eine Reaktion definieren, wenn der Fokus während der Bearbeitung das Control verlässt. |
| Enabled | Es kann eine Aktivierung oder Deaktivierung des Controls vorgenommen werden. True (Ja) = Der Anwender kann Text eingeben und formatieren. |
| Visible | Es kann eine Aktivierung oder Deaktivierung der Sichtbarkeit des Controls vorgenommen werden. |
¶ RichTextBox für Anwender
Für Anwender werden zwei verschiedene Werkzeugpaletten zur Textformatierung bereitgestellt je nachdem, ob das Formular mit dem FormViewer oder mit einem Browser bearbeitet wird. Die Toolbar im FormViewer entspricht der Toolbar im FormDesigner.
Die Werkzeuge für ein Web-Formular sind nebenstehend abgebildet.
Im Web-Formular kann ein Anwender in der RichTextBox zusätzlich
- Tabellen und
- Weblinks in einen Text einsetzen.
Ab Maskito 7.1 wird die Werkzeugleiste der RichTextBox im modernen Design dargestellt und ist zusätzlich per Rechtsklick als Kontextmenü bei Boxen verfügbar, die schmaler als 200 px bzw. weniger als 90 px hoch sind. Nach Maskito 7.2 gilt die neue Breite von 215 Pixel für den Wechsel zwischen Werkzeugleiste und Kontextmenü. Als neue Funktionalitäten bringt die Werkzeugleiste den Vollbildmodus, die umfangreichere Bild- und Tabellenbearbeitung, die Formatieren-Löschen-Schaltfläche sowie viele andere Features mit.
¶ Tipps und Tricks
- Nutzen Sie auch hier die Möglichkeit der Ersetzung von Platzhaltern (z.B. ActiveDirectory, Umgebungsvariablen usw.)
- Setzen Sie die Eigenschaft "
BorderStyle" auf "None" und die RichTextBox integriert sich wunderbar in einen Brief. - Nutzen Sie für die rtf-Funktion die RTF-Ansicht im Dialog "
RTF Text bearbeiten": Kopieren Sie Ihren formatierten Text aus einer Datei im RTF-Format einfach direkt in das Eingabefeld. Auf diese Weise wird der Code für die Formatierung automatisch erstellt. - Formulare einfacher aktualisieren: Wenn Textfelder auf
XMLOutput=Truestehen, werden die Texte als Einträge pro Nutzer gespeichert. Damit lassen sich die Formulare schlecht aktualisieren. D.h. der Nutzer sieht immer die alten Texte, die extra für Ihn gespeichert werden, auch wenn das Formular überarbeitet wurde. Textfelder, die keine Formulareinträge sind, sollten also immer aufXMLOutput = Falsestehen, außer man möchte die Inhalte speichern. - Wird die RichTextBox anders im Web-Formular dargestellt als es im Entwurf im FormDesigner aussieht, sollten die Box-Eigenschaften
MaxHeightundSizeim FormDesigner überprüft werden: Die MaxHeight darf die in der Size definierte Höhe der Box nicht unterschreiten. - Die Operatoren
Größer alsbzw.Kleiner alssowie ähnliche Wertevergleiche sind ungeeignet für die Prüfung des Textinhalts von RichTextBoxen, da die Boxen zusätzlich zu den eingegebenen Zeichenfolgen, Bildern etc. auch die Informationen zur Formatierung enthalten. - Mittels Platzhaltern kann der Text-Wert einer RTF-Box per Funktion weiterverwendet werden. Mit der Platzhalter-Erweiterung
.Textwird die unformatierte Nutzereingabe bereitgestellt. Bei der Anwendung eines Platzhalters ohne Erweiterung wird dagegen der Text HTML-formatiert weitergegeben.