HeaderedContentControl.HeaderStringFormat Eigenschap

Definitie

Hiermee wordt een samengestelde tekenreeks opgehaald of ingesteld die aangeeft hoe de Header eigenschap moet worden opgemaakt als deze wordt weergegeven als een tekenreeks.

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

Waarde van eigenschap

Een samengestelde tekenreeks die aangeeft hoe de Header eigenschap moet worden opgemaakt als deze wordt weergegeven als een tekenreeks. De standaardwaarde is null.

Kenmerken

Voorbeelden

In het volgende voorbeeld wordt een TabControl verzameling Student objecten gekoppeld. De Student klas heeft een Name eigenschap, een verzameling Course objecten en implementeert de IFormattable.ToString methode om de Name student of een tekenreeks te retourneren waarin de cursussen van de leerling/student worden vermeld. In het voorbeeld wordt gebruikt HeaderStringFormat om de naam van een leerling/student in de Header namen van elke TabItem student (die overgaat van HeaderedContentControl) en de TabControl.ContentStringFormat lijst met cursusgegevens weer te geven voor elke leerling/student in de inhoud van de TabItemstudent.

<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>

In het volgende voorbeeld wordt de IFormattable.ToString methode geïmplementeerd om de Name student of een tekenreeks te retourneren waarin de cursussen van de leerling/student worden vermeld.

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

Opmerkingen

HeaderStringFormat kan een vooraf gedefinieerde, samengestelde of aangepaste tekenreeksindeling zijn. Zie Opmaaktypen voor meer informatie over tekenreeksindelingen. Als u de HeaderTemplate of HeaderTemplateSelector eigenschap van een HeaderedContentControleigenschap instelt, wordt de HeaderStringFormat eigenschap genegeerd.

Informatie over afhankelijkheidseigenschappen

Item Waarde
Id-veld HeaderStringFormatProperty
Eigenschappen van metagegevens ingesteld op true Geen

Van toepassing op