HeaderedContentControl.HeaderStringFormat Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft eine kombinierte Zeichenfolge ab, die angibt, wie die Header-Eigenschaft formatiert werden soll, wenn sie als Zeichenfolge angezeigt wird, oder legt diese fest.

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

String

Eine kombinierte Zeichenfolge, die die Formatierung der Header-Eigenschaft für die Anzeige als Zeichenfolge angibt. Der Standardwert ist null.

Attribute

BindableAttribute

Beispiele

Im folgenden Beispiel wird ein TabControl an eine Auflistung von Student -Objekten gebunden. Die Student Klasse verfügt über eine Name -Eigenschaft, eine Auflistung von Course -Objekten und implementiert die IFormattable.ToString -Methode, um entweder die Name des Kursteilnehmers oder eine Zeichenfolge zurückzugeben, die die Kurse des Kursteilnehmers auflistet. Das Beispiel verwendet HeaderStringFormat , um den Namen eines Kursteilnehmers in die Header der einzelnen TabItem (der von HeaderedContentControlerbt) und den TabControl.ContentStringFormat einzufügen, um die Kursliste für jeden Kursteilnehmer im Inhalt des TabItemanzuzeigen.

<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 des Kursteilnehmers 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 eines HeaderedContentControlfestlegen, wird die HeaderStringFormat -Eigenschaft ignoriert.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	HeaderStringFormatProperty
Metadateneigenschaften auf true festgelegt	Keine