Label-Steuerelement in canvas-appsLabel control in canvas apps

Ein Feld, das Daten wie Text, Zahlen, Datumsangaben oder Währung anzeigt.A box that shows data such as text, numbers, dates, or currency.

BeschreibungDescription

Eine Bezeichnung zeigt Daten an, die Sie als Textzeichenfolgenliteral angeben, das genauso angezeigt wird, wie Sie es eingeben, oder als Formel, die zu einer Textzeichenfolge ausgewertet wird.A label shows data that you specify as a literal string of text, which appears exactly the way you type it, or as a formula that evaluates to a string of text. Bezeichnungen werden häufig außerhalb anderer Steuerelemente (z.B. als Banner, das einen Bildschirm identifiziert), als Bezeichnung für die Identifizierung eines anderen Steuerelements (z.B. ein Bewertungs- oder Audiosteuerelement) oder in einer Galerie angezeigt, um einen bestimmten Typ von Information zu einem Element anzuzeigen.Labels often appear outside of any other control (such as a banner that identifies a screen), as a label that identifies another control (such as a rating or audio control), or in a gallery to show a specific type of information about an item.

HaupteigenschaftenKey properties

AutoHeight : durch Festlegen auf "true", um die Bezeichnung auf den gesamten Text werden, um automatische Vergrößerung zu ermöglichen.AutoHeight – Set to true to allow the label to auto-grow its height to show all text. Durch Festlegen auf FALSE wird der Text auf die zugewiesene Größe abgeschnitten.Set to false to truncate the text to the height assigned.

Color – Die Farbe des Texts in einem Steuerelement.Color – The color of text in a control.

Font – Der Name der Schriftfamilie des angezeigten Texts.Font – The name of the family of fonts in which text appears.

Text – Text, der in einem Steuerelement angezeigt wird oder von einem Benutzer in ein Steuerelement eingegeben wird.Text – Text that appears on a control or that the user types into a control.

DelayOutput: Durch Festlegen auf TRUE wird eine Aktion während der Texteingabe verzögert.DelayOutput – Set to true to delay action during text input.

Zusätzliche EigenschaftenAdditional properties

Align – Die Position von Text in Relation zur horizontalen Mitte des Steuerelements.Align – The location of text in relation to the horizontal center of its control.

AutoHeight: Gibt an, ob die Height-Eigenschaft einer Bezeichnung automatisch erhöht wird, wenn ihre Text-Eigenschaft mehr Zeichen enthält, als das Steuerelement gleichzeitig anzeigen kann.AutoHeight – Whether a label automatically increases its Height property if its Text property contains more characters than the control can show at one time.

BorderColor – Die Farbe des Rahmens eines Steuerelements.BorderColor – The color of a control's border.

BorderStyle – Legt fest, ob der Rahmen eines Steuerelements Solid (Durchgehend), Dashed (Gestrichelt), Dotted (Gepunktet) oder None (Keiner) ist.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – Die Stärke des Rahmens eines Steuerelements.BorderThickness – The thickness of a control's border.

DisplayMode: Legt fest, ob das Steuerelement Benutzereingaben zulässt (Edit, Bearbeiten), ob nur Daten angezeigt werden (View, Anzeigen) oder ob das Steuerelement deaktiviert ist (Disabled, Deaktiviert).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor: Die Farbe des Steuerelementrahmens, wenn die DisplayMode-Eigenschaft des Steuerelements auf Disabled (Deaktiviert) festgelegt ist.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

DisabledColor: Die Farbe des Texts in einem Steuerelement, wenn seine DisplayMode-Eigenschaft auf Disabled (Deaktiviert) festgelegt ist.DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill: Die Hintergrundfarbe eines Steuerelements, wenn dessen DisplayMode-Eigenschaft auf Disabled (Deaktiviert) festgelegt ist.DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.

Fill – Die Hintergrundfarbe eines Steuerelements.Fill – The background color of a control.

FocusedBorderColor: die Rahmenfarbe eines Steuerelements, wenn das Steuerelement der Fokus ist.FocusedBorderColor – The color of a control's border when the control is focused.

FocusedBorderThickness: die Rahmendicke eines Steuerelements, wenn das Steuerelement der Fokus ist.FocusedBorderThickness – The thickness of a control's border when the control is focused.

FontWeight – die Schriftbreite des Texts in einem Steuerelement: Fett, Semibold, Normal, oder heller.FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Height – Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.Height – The distance between a control's top and bottom edges.

HoverBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger über das Steuerelement hält.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor – Die Farbe des Texts in einem Steuerelement, wenn der Benutzer den Mauszeiger über ihm hält.HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – Die Hintergrundfarbe eines Steuerelements, wenn der Benutzer den Mauszeiger über ihm hält.HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic – Legt fest, ob der Text in einem Steuerelement kursiv formatiert ist.Italic – Whether the text in a control is italic.

LineHeight: Der Abstand zwischen Elementen, z.B. Textzeilen oder Elementen in einer Liste.LineHeight – The distance between, for example, lines of text or items in a list.

Live : wie eine Bildschirmsprachausgabe Änderungen des Werts, der die Bezeichnung kündigt Text Eigenschaft.Live – How a screen reader announces changes to the value of the label's Text property.

  • Bei Festlegung auf aus, die Sprachausgabe keine Änderungen bekanntgeben zu können.When set to Off, the screen reader doesn't announce changes.
  • Bei Festlegung auf Polite, die Sprachausgabe abgeschlossen ist, das halten öffentlicher Vorträge Ankündigung: Änderungen, die beim Ausführen die Sprachausgabe gesprochen habe.When set to Polite, the screen reader finishes speaking before announcing any changes that occurred while the screen reader was speaking.
  • Bei Festlegung auf Assertive, die Sprachausgabe von Hardwareinterrupts benötigt hat sich alle Änderungen, die aufgetreten sind, während die Sprachausgabe gesprochen habe, ankündigen zu können.When set to Assertive, the screen reader interrupts itself to announce any changes that occurred while the screen reader was speaking.

OnSelect – Legt fest, wie die App reagiert, wenn der Benutzer auf ein Steuerelement tippt oder klickt.OnSelect – How the app responds when the user taps or clicks a control.

Overflow: Gibt an, ob eine Bildlaufleiste in einer Bezeichnung angezeigt wird, wenn die Wrap-Eigenschaft auf TRUE festgelegt ist und der Wert der Text-Eigenschaft des Steuerelements mehr Zeichen enthält, als das Steuerelement gleichzeitig anzeigen kann.Overflow – Whether a scrollbar appears in a label if its Wrap property is set to true and the value of the control's Text property contains more characters than the control can show at one time.

PaddingBottom: Der Abstand zwischen dem Text eines Steuerelements und dem unteren Rand des Steuerelements.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft: Der Abstand zwischen dem Text eines Steuerelements und dem linken Rand des Steuerelements.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight: Der Abstand zwischen dem Text eines Steuerelements und dem rechten Rand des Steuerelements.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop: Der Abstand zwischen dem Text eines Steuerelements und dem oberen Rand des Steuerelements.PaddingTop – The distance between text in a control and the top edge of that control.

PressedBorderColor – Die Rahmenfarbe eines Steuerelements, wenn der Benutzer auf das Steuerelement tippt oder klickt.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor – Die Farbe des Texts in einem Steuerelement, wenn der Benutzer auf das Steuerelement tippt oder klickt.PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – Die Hintergrundfarbe eines Steuerelements, wenn der Benutzer auf das Steuerelement tippt oder klickt.PressedFill – The background color of a control when the user taps or clicks that control.

Rolle -die semantischen Rolle der Text der Bezeichnung, z. B. Überschrift 1.Role - The semantic role of the label text, such as Heading 1. Das Format der Bezeichnung ändert sich nicht, aber macht die Ausgabe für die Interpretation von der Sprachausgabe semantisch richtige.Doesn't change the style of the label but makes the output semantically correct for interpretation by screen readers.

Size – Der Schriftgrad des Texts, der in einem Steuerelement angezeigt wird.Size – The font size of the text that appears on a control.

Strikethrough – Legt fest, ob der in einem Steuerelement angezeigte Text durchgestrichen ist.Strikethrough – Whether a line appears through the text that appears on a control.

TabIndex: Navigationsreihenfolge der Tastatur in Bezug auf andere Steuerelemente.TabIndex – Keyboard navigation order in relation to other controls.

Tooltip: Erklärender Text, der angezeigt wird, wenn der Benutzer auf ein Steuerelement zeigt.Tooltip – Explanatory text that appears when the user hovers over a control.

Underline – Legt fest, ob der in einem Steuerelement angezeigte Text unterstrichen ist.Underline – Whether a line appears under the text that appears on a control.

VerticalAlign – Die Position des Texts in einem Steuerelement in Relation zur vertikalen Mitte des Steuerelements.VerticalAlign – The location of text on a control in relation to the vertical center of that control.

Visible – Legt fest, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.Visible – Whether a control appears or is hidden.

Width – Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.Width – The distance between a control's left and right edges.

Wrap: Gibt an, ob Text, der zu lang für eine Bezeichnung ist, in die nächste Zeile umbrochen wird.Wrap – Whether text that's too long to fit in a label wraps to the next line.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (bzw. des Bildschirms, wenn kein übergeordneter Container vorhanden ist).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (bzw. des Bildschirms, wenn kein übergeordneter Container vorhanden ist).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

Text( Zahl; "CodesFormatieren" )Text( Number; "FormatCodes" )

BeispieleExamples

Anzeigen eines ZeichenfolgenliteralsShow a literal string

Anzeigen des Ergebnisses einer FormelShow the result of a formula

  • Fügen Sie eine Bezeichnung hinzu, und legen Sie deren Text-Eigenschaft auf eine Formel wie diese fest:Add a label, and set its Text property to a formula such as this one:
    Today()Today()

    Hinweis

    Verwenden Sie beim Angeben einer Formel nur Anführungszeichen, wenn ein Argument der Formel ein Zeichenfolgenliteral ist.When you specify a formula, you don't use quotation marks unless an argument of the formula is a literal string. Umschließen Sie in diesem Fall das Argument und nicht die Formel mit doppelten Anführungszeichen.In that case, enclose the argument, not the formula, in double quotation marks.

    Benötigen Sie weitere Informationen zur Today-Funktion oder anderen Funktionen?Want more information about the Today function or other functions?

In diesem Verfahren erstellen Sie eine Sammlung mit dem Namen CityPopulations, die Daten über die Bevölkerung verschiedener Städte in Europa enthält.In this procedure, you'll create a collection, called CityPopulations, that contains data about the population of various cities in Europe. Als Nächstes zeigen Sie diese Daten in einem Katalog an, der drei Bezeichnungen enthält, und geben den Datentyp an, der in jeder Bezeichnung angezeigt wird.Next, you'll show that data in a gallery that contains three labels, and you'll specify the type of data that each label will show.

  1. Fügen Sie eine Schaltfläche hinzu, und legen Sie ihre Eigenschaft OnSelect auf diese Formel fest:Add a button, and set its OnSelect property to this formula:
    ClearCollect(CityPopulations; {City:"London"; Country:"United Kingdom"; Population:8615000}; {City:"Berlin"; Country:"Germany"; Population:3562000}; {City:"Madrid"; Country:"Spain"; Population:3165000}; {City:"Rome"; Country:"Italy"; Population:2874000}; {City:"Paris"; Country:"France"; Population:2273000}; {City:"Hamburg"; Country:"Germany"; Population:1760000}; {City:"Barcelona"; Country:"Spain"; Population:1602000}; {City:"Munich"; Country:"Germany"; Population:1494000}; {City:"Milan"; Country:"Italy"; Population:1344000})ClearCollect(CityPopulations; {City:"London"; Country:"United Kingdom"; Population:8615000}; {City:"Berlin"; Country:"Germany"; Population:3562000}; {City:"Madrid"; Country:"Spain"; Population:3165000}; {City:"Rome"; Country:"Italy"; Population:2874000}; {City:"Paris"; Country:"France"; Population:2273000}; {City:"Hamburg"; Country:"Germany"; Population:1760000}; {City:"Barcelona"; Country:"Spain"; Population:1602000}; {City:"Munich"; Country:"Germany"; Population:1494000}; {City:"Milan"; Country:"Italy"; Population:1344000})

  2. Drücken Sie F5, wählen Sie die Schaltfläche aus, und drücken Sie dann die ESC-TASTE.Press F5, select the button, and then press Esc.

  3. Fügen Sie einen Textkatalog hinzu, und legen Sie dessen Items-Eigenschaft auf CityPopulations fest.Add a text gallery, and set its Items property to CityPopulations.

    Wenn der Katalog ausgewählt ist, werden im rechten Bereich Optionen für diesen Katalog angezeigt.When the gallery is selected, the right pane shows options for that gallery.

  4. Legen Sie im Bereich Gallery1 die obere Liste auf Population, die mittlere Liste auf City und die untere Liste auf Country fest.In the Gallery1 pane, set the top list to Population, set the middle list to City, and set the bottom list to Country.

Richtlinien für BarrierefreiheitAccessibility guidelines

Ein Bezeichnungs-Steuerelement wird nicht ausschließlich als Bezeichnung für ein anderes Steuerelement verwendet.Despite its name, a Label control does not have to be used as a label for another control. Es kann auch verwendet werden, um ein beliebiges Textfragment anzuzeigen.It can be used to display any piece of text.

Außerdem kann es als Schaltfläche oder Link verwendet werden, indem OnSelect-Verhalten angegeben wird.A Label can be used as a button or link by specifying OnSelect behavior. Wenn das Steuerelement auf diese Weise verwendet wird, gelten ähnliche Aspekte im Hinblick auf die Barrierefreiheit wie bei Schaltflächen.When used this way, there are similar accessibility considerations as with buttons.

FarbkontrastColor contrast

Zwischen folgenden Eigenschaften muss es einen ausreichenden Farbkontrast geben:There must be adequate color contrast between:

SprachausgabeunterstützungScreen-reader support

  • Die Text-Eigenschaft muss vorhanden sein.Text must be present.

  • Live sollte festgelegt werden, um Polite oder Assertive , wenn eine Sprachausgabe Änderungen an den Wert der ankündigen sollte die Text Eigenschaft.Live should be set to Polite or Assertive if a screen reader should announce changes to the value of the Text property.

    Hinweis

    Bezeichnungen werden von der Sprachausgabe als Schaltflächen angesehen, wenn TabIndex gleich 0 oder größer ist.Screen readers will treat Labels as buttons when TabIndex is zero or greater.

Unterstützte Anpassungen für Menschen mit SehbehinderungenLow vision support

  • Wenn eine Bezeichnung als Link verwendet wird, sollte diese auch wie ein Link aussehen.Label should look like a link, if it is used as a link.

TastaturunterstützungKeyboard support

  • TabIndex muss gleich 0 (null) oder größer sein, wenn der Text als Schaltfläche oder Link verwendet wird.TabIndex must be zero or greater, if the text is used as a button or link. So können Benutzer per Tastatur dorthin navigieren.This allows keyboard users to navigate to it.
  • Fokusindikatoren müssen übersichtlich angezeigt werden, wenn der Text als Schaltfläche oder Link verwendet wird.Focus indicators must be clearly visible, if the text is used as a button or link. FocusedBorderColor und FocusedBorderThickness können Ihnen dabei helfen.Use FocusedBorderColor and FocusedBorderThickness to achieve this.