HeaderedContentControl.HeaderStringFormat Eigenschaft

Definition

Ruft eine kombinierte Zeichenfolge ab, die angibt, wie die Header-Eigenschaft formatiert werden soll, wenn sie als Zeichenfolge angezeigt wird, oder legt diese fest.Gets or sets a composite string that specifies how to format the Header property if it is displayed as a string.

public:
 property System::String ^ HeaderStringFormat { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string HeaderStringFormat { get; set; }
member this.HeaderStringFormat : string with get, set
Public Property HeaderStringFormat As String

Eigenschaftswert

Eine kombinierte Zeichenfolge, die die Formatierung der Header-Eigenschaft für die Anzeige als Zeichenfolge angibt.A composite string that specifies how to format the Header property if it is displayed as a string. Die Standardeinstellung ist null.The default is null.

Attribute

Beispiele

Im folgenden Beispiel wird ein TabControl an eine Auflistung von Student -Objekten gebunden.The following example binds a TabControl to a collection of Student objects. Die Student -Klasse verfügt Name über eine-Eigenschaft, Course eine Auflistung von-Objekten IFormattable.ToString und implementiert die-Methode Name , um entweder den des Studenten oder eine Zeichenfolge zurückzugeben, die die Kurse des Studenten auflistet.The Student class has a Name property, a collection of Course objects, and implements the IFormattable.ToString method to return either the Name of the student or a string that lists the student's courses. In dem Beispiel HeaderStringFormat wird verwendet, um den Namen eines Schülers Header in den TabItem von jedem zu platzieren ( HeaderedContentControl TabControl.ContentStringFormat der erbt), und, um die Kursliste für jeden Schüler/Student im TabItemInhalt der anzuzeigen.The example uses HeaderStringFormat to put a student's name in the Header of each TabItem (which inherits from HeaderedContentControl), and the TabControl.ContentStringFormat to display the course list for each student in the Content of the TabItem.

<Grid>
  <Grid.Resources>
    <src:Students x:Key="Students"/>

    <Style TargetType="TabItem">
      <Setter Property="HeaderStringFormat" Value="n"/>
      <Setter Property="FontFamily" Value="Lucida Sans Unicode"/>
      <Setter Property="Foreground" Value="Green"/>
      <Setter Property="FontWeight" Value="Bold"/>
    </Style>
  </Grid.Resources>

  <TabControl ItemsSource="{StaticResource Students}"
              FontFamily="Lucida Console" Foreground="Navy"
              ContentStringFormat="cl"/>
</Grid>

Im folgenden Beispiel wird die IFormattable.ToString -Methode implementiert, um Name entweder den des Studenten oder eine Zeichenfolge zurückzugeben, die die Kurse des Studenten auflistet.The following example implements the IFormattable.ToString method to return either the Name of the student or a string that lists the student's courses.

public string ToString(string format, IFormatProvider formatProvider)
{
    // 'n': print the name only.
    if (format == "n")
    {
        return Name;
    }

    // 'cl': print the course list.
    if (format == "cl")
    {
        string stringFormat = "{0,-25}{1,-30}{2,-10}\r\n";

        StringBuilder str = new StringBuilder();

        str.AppendLine(); 
        str.AppendFormat(stringFormat, "Title", "Description", "ID");
        str.AppendLine(); 

        foreach (Course c in Courses)
        {
            str.AppendFormat(stringFormat, c.Title, c.Description, c.SectionID);
        }

        return str.ToString();
    }

    return this.ToString();
}
Public Overloads Function ToString(ByVal format As String, ByVal formatProvider As IFormatProvider) As String Implements IFormattable.ToString
    ' 'n': print the name only.
    If format = "n" Then
        Return Name
    End If

    ' 'cl': print the course list.
    If format = "cl" Then
        Dim stringFormat As String = "{0,-25}{1,-30}{2,-10}" & vbCrLf

        Dim str As New StringBuilder()

        str.AppendLine()
        str.AppendFormat(stringFormat, "Title", "Description", "ID")
        str.AppendLine()

        For Each c As Course In Courses
            str.AppendFormat(stringFormat, c.Title, c.Description, c.SectionID)
        Next c

        Return str.ToString()
    End If

    Return Me.ToString()
End Function

Hinweise

HeaderStringFormatkann ein vordefiniertes, zusammengesetztes oder benutzerdefiniertes Zeichen folgen Format sein.HeaderStringFormat can be a predefined, composite, or custom string format. Weitere Informationen zu Zeichen folgen Formaten finden Sie unter Formatieren von Typen.For more information about string formats, see Formatting Types. Wenn Sie die- HeaderTemplate Eigenschaft HeaderTemplateSelector oder die- HeaderedContentControlEigenschaft eines HeaderStringFormat festlegen, wird die-Eigenschaft ignoriert.If you set the HeaderTemplate or HeaderTemplateSelector property of a HeaderedContentControl, the HeaderStringFormat property is ignored.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field HeaderStringFormatProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für: