ResizableTextArea Kontrolle

Eine Komponente für Benutzereingaben.

Notiz

Sie finden die vollständige Dokumentation und den Quellcode im GitHub-Codekomponenten-Repository.

Beschreibung des Dataflows

Textbereiche bieten Benutzern die Möglichkeit, Text einzugeben und zu bearbeiten. Sie werden in Formularen, modalen Dialogfeldern, Tabellen und anderen Oberflächen verwendet, in denen Texteingaben erforderlich sind.

Diese Komponente ermöglicht es dem Benutzer, die Größe des Textbereichs bequem zu ändern.

Notiz

Komponenten-Quellcode und weitere Informationen finden Sie im GitHub-Codekomponenten-Repository.

Eigenschaften

Schlüsseleigenschaften

Eigenschaften	Beschreibung des Dataflows
Text	Der im Steuerelement festgelegte Textwert. Dies ist die standardmäßige gebundene Eigenschaft, wenn sie in einer Modellgesteuerten App verwendet wird.
Default	Der Standardwert, den das Steuerelement haben wird, wenn das Steuerelement zurückgesetzt oder der Standardwert geändert wird. Dadurch funktioniert das Steuerelement ähnlich wie Steuerelemente in Canvas-App-Formularen.
MaxLength	Die maximale Anzahl von Zeichen, die eingegeben werden können.
HintText	Der Text, der angezeigt wird, wenn kein Textwert festgelegt wurde.
EmptyPlaceholderText	Der Text, der angezeigt wird, wenn kein Wert vorhanden ist, und das Steuerelement keinen Fokus hat. Dies stellt einen ähnlichen Stil wie das Modellgesteuerte Textsteuerelement bereit, das --- anzeigt, wenn kein Wert ausgefüllt ist.
DefaultHeight	Die Höhe, auf die der Textbereich zu Beginn festgelegt sein soll. Wenn dies nicht in einer Canvas-App/auf einer benutzerdefinierten Seite festgelegt ist, wird die Größe standardmäßig auf die Höhe der Codekomponente eingestellt. Dies ist bei Modellgesteuerten Apps erforderlich, da das Formular keine anfängliche Höhe bereitstellt.
DefaultWidth	Die Breite, auf die der Textbereich anfänglich festgelegt werden soll. Wenn dies nicht in einer Canvas-App/auf einer benutzerdefinierten Seite festgelegt ist, wird die Größe standardmäßig auf die Höhe der Codekomponente eingestellt. Dies ist bei Modellgesteuerten Apps nicht erforderlich, da die Standardbreite die Breite der Formularspalte ist.
MinHeight	Die Mindesthöhe, auf die die textarea geändert werden kann. Für keine Begrenzung auf Null setzen.
MaxHeight	Die Maximalhöhe, auf die die textarea geändert werden kann. Für keine Begrenzung auf Null setzen.
Min Width	Die Mindestbreite, auf die die textarea geändert werden kann. Für keine Begrenzung auf Null setzen.
MaxWidth	Die Maximalbreite, auf die die textarea geändert werden kann. Für keine Begrenzung auf Null setzen.
AllowResize	Definiert, in welche Richtung die textarea geändert werden kann. „Keine“, „Beide“, „Vertikal“ oder „Horizontal“.
EnableSpellCheck	Definiert, ob der Browser die textarea auf Rechtschreibung prüfen soll oder nicht.

Ausgabeeigenschaften

Eigenschaften	Beschreibung
Resized Height** (output) - The user adjusted height | Angepasste Breite** (Ausgabe) – Die vom Benutzer angepasste Breite

Stileigenschaften

Eigenschaften	Beschreibung des Dataflows
PaddingLeft	Der Abstand, der innerhalb der textarea hinzugefügt werden soll.
PaddingRight	Der Abstand, der innerhalb der textarea hinzugefügt werden soll.
PaddingTop	Der Abstand, der innerhalb der textarea hinzugefügt werden soll.
PaddingBottom	Der Abstand, der innerhalb der textarea hinzugefügt werden soll.
Left Padding Adjustment	In einer Modellgesteuerten App gibt es auch bei ausgeblendeter Beschriftung links neben der Codekomponente einen Abstand für Symbole (z. B. Schlosssymbol). Um dies zu korrigieren, muss die Breite verringert werden, indem die linke Abstandsanpassung auf 21 eingestellt wird. Ist auch eine Beschriftung vorhanden, muss die linke Abstandsanpassung auf die Breite der Beschriftung eingestellt werden.
RenderBorderStyle	Das kann entweder Normal oder Zentriert sein. Bei einer Einstellung auf „Normal“ wird die Randbreite innerhalb des Textbereichsfelds erhöht. Bei einer Verwendung von Zentriert wird der Rahmen um den Rand des Textbereichsfelds zentriert. Verwenden Sie „Zentriert“, um mit den Klassischen Power Apps-Steuerelementen kompatibel zu sein und „Normal“ für Modellgesteuerte und Fluent-UI-Steuerelemente.
Accessibility Label	Die Arienbeschriftung

Nicht alle Kombinationen von Stil/Status werden von jeder Komponente implementiert. Weitere Informationen finden Sie im Abschnitt zu Statusabhängigen Stileigenschaften der GitHub-Komponentendokumentation.

Ereigniseigenschaften

Eigenschaften	Beschreibung des Dataflows
Input Event	Legen Sie die Eigenschaft „Eingabeereignis“ auf eine Zeichenfolge fest, die im SetFocus beginnt, um den Fokus auf das Steuerelement zu legen. Sie müssen ein zufälliges Suffix angeben, damit das Ereignis ausgelöst wird.

Andere Eigenschaften entsprechen dem standardmäßigen Texteingabesteuerelement.

Behavior

Unterstützt SetFocus als InputEvent.

Einschränkungen

Diese Codekomponente kann nur in Canvas-Apps, benutzerdefinierten Seiten und Modellgesteuerten Apps verwendet werden.

Weitere Hinweise auf Einschränkungen finden Sie im Abschnitt zu gestalterischen Herausforderungen der GitHub-Dokumentation.