Freigeben über


HeaderedContentControl.HeaderStringFormat Eigenschaft

Definition

Dient zum Abrufen oder Festlegen einer zusammengesetzten Zeichenfolge, die angibt, wie die Header Eigenschaft formatiert wird, wenn sie als Zeichenfolge angezeigt wird.

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

Eigenschaftswert

Eine zusammengesetzte Zeichenfolge, die angibt, wie die Header Eigenschaft formatiert wird, wenn sie als Zeichenfolge angezeigt wird. Der Standardwert lautet null.

Attribute

Beispiele

Im folgenden Beispiel wird eine TabControl Bindung an eine Auflistung von Student Objekten ausgeführt. Die Student Klasse verfügt über eine Name Eigenschaft, eine Auflistung von Course Objekten und implementiert die IFormattable.ToString Methode, um entweder den Name Kurs des Kursteilnehmers oder eine Zeichenfolge zurückzugeben, die die Kurse des Kursteilnehmers auflistet. Im Beispiel wird HeaderStringFormat der Name eines Kursteilnehmers in die Header einzelnen TabItem (erbt von HeaderedContentControl) und die TabControl.ContentStringFormat Kursliste für jeden Kursteilnehmer im Inhalt der TabItemKursteilnehmer angezeigt.

<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 entweder den Name Kursteilnehmer oder eine Zeichenfolge zurückzugeben, die die Kurse des Kursteilnehmers auflistet.

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

HeaderStringFormat kann ein vordefiniertes, zusammengesetztes oder benutzerdefiniertes Zeichenfolgenformat sein. Weitere Informationen zu Zeichenfolgenformaten finden Sie unter "Formatierungstypen". Wenn Sie die HeaderTemplate Eigenschaft oder HeaderTemplateSelector Eigenschaft einer HeaderedContentControlEigenschaft festlegen, wird die HeaderStringFormat Eigenschaft ignoriert.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld HeaderStringFormatProperty
Auf Metadateneigenschaften festgelegt true Nichts

Gilt für: