Rich-Text-Editor

Sie können das Steuerelement Rich-Text-Editor verwenden, damit Benutzer in Ihrer App Rich Text verfassen können. Dieser Text kann dann als E-Mail-Inhalt, Marketinginhalt und mehr verwendet werden.

Entwurfszeit

Allgemein

• Hinweistext – Der Hilfetext, der zur Laufzeit angezeigt werden soll.
• Standardtext – Der Standardinhalt, der zur Laufzeit angezeigt werden soll. Wenn diese Eigenschaft an eine App-Variable gebunden ist, werden Änderungen am Standardwert nicht an die App-Variable weitergegeben. Um Werte in App-Variablen zu aktualisieren, sollten Sie eine Regel Werte festlegen verwenden.
• Beschriftung – Der Anzeigetext des Steuerelements.
• Erforderlich – Bei „true“ müssen App-Benutzer Daten im Steuerelement angeben. Um das Steuerelement zur Laufzeit als obligatorisch zu markieren, wird nach dem Beschriftungstext ein Sternchen * hinzugefügt.
• Benutzerdefinierte Fehlermeldung – Der Text, der angezeigt wird, wenn die Eigenschaft Erforderlich auf „true“ festgelegt ist und das Steuerelement leer bleibt.
• Ausgeblendet – Bei „true“ wird das Steuerelement während der Runtime ausgeblendet.
• Schreibgeschützt – Bei „true“ können Sie zur Laufzeit keinen Text hinzufügen, aber der vorhandene Inhalt wird angezeigt und kann nicht bearbeitet werden.

Events

• Wert geändert – Konfigurieren Sie, was passiert, wenn der Inhalt geändert wird.

Stil

• Ausrichtung von Steuerelementen – Erbt standardmäßig die übergeordnete Ausrichtung. Eine andere Ausrichtung als die übergeordnete kann festgelegt werden. Um die Standardausrichtung wiederherzustellen, heben Sie die Markierung der überschriebenen Optionen auf.

  Hinweis: Die Ausrichtung hängt vom Layout ab, das für das übergeordnete Element ausgewählt wurde (vertikal vs. horizontal).
• Beschriftungsplatzierung – Standardmäßig wird die Beschriftung so eingestellt, dass sie oben auf dem Steuerelement auf der linken Seite angezeigt wird. Sie können es links neben dem Steuerelement in derselben Zeile platzieren. Die Eigenschaft Beschriftungsbreite konfiguriert, wie breit die Beschriftung sein soll, und die Eigenschaft Zwischenraum legt den Abstand zwischen der Beschriftung und dem Steuerelement fest.

• Schriftart – Die Schriftartattribute für den Beschriftungstext, z. B. Schriftfamilie, Größe, Farbe oder Stil (Fett, Kursiv und Unterstrichen). Standardmäßig erbt das Steuerelement die Schriftfamilie des unmittelbar übergeordneten Containers, der durch das Schlüsselwort „Geerbt“ angegeben wird.

• Seitenrand – Der Seitenrand des Steuerelements. Standardmäßig ist ein Seitenrand von 4px festgelegt. Die Randeigenschaften Oben/Unten und Links/Rechts werden kombiniert. Diese Eigenschaften können mit der Schaltfläche Link rechts neben dem Abschnitt Seitenrand getrennt werden.
• Größe – Die Breite und Höhe des Steuerelements. Standardmäßig ist die Größe auf auto festgelegt. Um Mindest- oder Höchstwerte festzulegen, klicken Sie auf das Drei-Punkte-Symbol (…). Wenn die Größe des Steuerelements kleiner ist als die Optionen, wird eine Bildlaufleiste angezeigt.

Hinweis: Wenn die Ausrichtung der Steuerelemente auf Strecken und das übergeordnete Steuerelement auf Umbrechen zulassen festgelegt ist, wird das Steuerelement Rich-Text-Editor nicht auf die volle Höhe gedehnt. Um dies zu vermeiden, können Sie die Ausrichtungsoption Strecken aufheben oder eine explizite Höhe für das Steuerelement angeben.

Laufzeit

Überblick

Verwenden Sie dieses Steuerelement, um während der Laufzeit direkt aus der App Rich-Text zu erstellen.

Hinweis: Wenn Sie das Feld Schreibgeschützt während der Laufzeit auswählen, ändert sich die Benutzeroberfläche des Rich-Text-Editors: Die Bearbeitungssteuerelemente sind ausgeblendet und Sie können keinen neuen Text hinzufügen oder den vorhandenen Text bearbeiten.

Interface

Die Schnittstelle bietet nützliche Funktionen, wie z. B.:

• Schriftart – Personalisieren Sie die Schriftart. Sie können zwischen den folgenden Optionen wählen:

  • Fett
  • Kursiv
  • Unterstrichen
  • Aufzählungsliste – Erstellen Sie eine Aufzählungsliste.
  • Nummerierte Liste – Erstellen Sie eine nummerierte Liste.
  • Tabelle – Erstellen Sie eine Tabelle. Sie können den Stil der Tabelle (Größe, Ausrichtung, Hintergrundfarbe, Rahmen) ändern, indem Sie Tabelleneigenschaften aus dem Dropdownmenü auswählen.
  • Schriftfamilie
  • Font size
  • Textfarbe
  • Texthintergrundfarbe

• Ausrichtung – Richtet den Inhalt über das Steuerelement Rich-Text-Editor aus.

  • Links ausrichten – Richtet den Text am linken Rand aus.
  • Rechts ausrichten – Richtet den Text am rechten Rand aus.
  • Mittig ausrichten – Richtet den Text zwischen zwei Rändern aus.
  • Im Blocksatz ausrichten – Der Abstand zwischen den Wörtern wird so vergrößert, dass er die gesamte Zeile ausfüllt, so dass sie sowohl am linken als auch am rechten Rand ausgerichtet ist.
• Einrückung verkleinern und vergrößern – Der Abstand zwischen dem linken und rechten Rand eines Absatzes kann vergrößert oder verkleinert werden.
• Zeilenhöhe – Ändern Sie den Bereich zwischen zwei Zeilen.
• Hochstellung und Tiefstellung – Formatieren Sie den Text so, dass er entweder etwas höher (hochgestellt) oder tiefer (tiefgestellt) als die normale Schriftzeile steht.
• Formatierung löschen – Entfernen Sie die gesamte Formatierung eines markierten Textblocks, eines Absatzes oder des gesamten Textes.
• Bild einfügen/bearbeiten – Fügen Sie ein Bild aus einem Speicher-Bucket ein.
• Blockzitat – Angabe des Zitats einer umfangreichen Textpassage aus einer anderen Quelle.
• Horizontale Linie – Fügen Sie eine horizontale Linie ein.
• Link einfügen/bearbeiten – Fügen Sie eine öffentliche URL ein oder bearbeiten Sie sie. Sie können sie auch so konfigurieren, dass sie im selben Fenster oder in einem neuen Fenster geöffnet wird.
• Rückgängig machen und Wiederholen – Machen Sie alle Änderungen rückgängig oder wiederholen Sie sie bei Bedarf.

Tastenkombinationen

Wichtig:

Derzeit funktionieren die Tastenkombinationen CTRL+C und CTRL+V auf Windows-Maschinen nicht für eingebettete oder Bild-Popups, die im Steuerelement Rich Text Editor angezeigt werden.

Verwenden Sie stattdessen CTRL+SHIFT+C und CTRL+SHIFT+V.

Sie können die folgenden Tastenkombinationen verwenden, um auf die Symbolleiste des Steuerelements zuzugreifen:

Aufgabe	PC (nicht macOS)	macOS
Fokussieren oder zur Menüleiste springen	ALT+F9	Option+F9
Fokussieren oder zur Symbolleiste springen	ALT+F10	Wahltaste+F10

VB-Eigenschaften

VB-Eigenschaft	Datentyp	Beschreibung
Tooltip	String	Informationstext, der angezeigt wird, wenn der Benutzer mit dem Mauszeiger auf den Rich-Text-Editor zeigt.
HintText	String	Platzhaltertext, der im Rich-Text-Editor angezeigt wird.
Label	String	Die Bezeichnung des Rich-Text-Editors, in der Regel Text, der vor dem Steuerelement angezeigt wird.
Schreibgeschützt	Boolescher	Bei „true“ ist der Rich-Text-Editor zur Laufzeit schreibgeschützt.
Wert	String	Aktuell ausgewählter Wert des Rich-Text-Editors.
Erforderlich	Boolescher	Gibt an, ob der Wert des Rich-Text-Editors obligatorisch ist.
RequiredErrorMessage	String	Meldung, die angezeigt wird, wenn der Wert des Rich-Text-Editors erforderlich ist, aber nicht angegeben wurde.
Ausgeblendet	Boolescher	Bestimmt die Sichtbarkeit des Rich-Text-Editors. Wenn diese Option auf „true“ festgelegt ist, wird das Steuerelement zur Laufzeit ausgeblendet.
Deaktiviert	Boolescher	Bestimmt, ob der Rich-Text-Editor interaktionsfähig ist. Bei „true“ wird die Interaktion mit dem Rich-Text-Editor zur Laufzeit deaktiviert.
IstGültig	Boolescher	Überprüft die Gültigkeit des Rich-Text-Editor- Werts. „true“ gibt an, dass sie gültig ist.