TabControl.ContentStringFormat Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Pobiera ciąg złożony określający sposób formatowania zawartości TabItem obiektów, jeśli są one wyświetlane jako ciągi.

public:
 property System::String ^ ContentStringFormat { System::String ^ get(); void set(System::String ^ value); };

public string ContentStringFormat { get; set; }

member this.ContentStringFormat : string with get, set

Public Property ContentStringFormat As String

Wartość właściwości

String

Ciąg złożony określający sposób formatowania zawartości TabItem obiektów, jeśli są one wyświetlane jako ciągi.

Przykłady

Poniższy przykład wiąże obiekt z TabControl kolekcją Student obiektów. Klasa Student ma właściwość, kolekcję Course obiektów i implementuje IFormattable.ToString metodę Name zwracaną przez Name ucznia lub ciąg, który zawiera listę kursów ucznia. W przykładzie użyto HeaderedContentControl.HeaderStringFormat metody , aby umieścić nazwę ucznia w Header każdej z nich TabItem (która dziedziczy po HeaderedContentControl), a element ContentStringFormat , aby wyświetlić listę kursów dla każdego ucznia w zawartości elementu 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>

Poniższy przykład implementuje metodę IFormattable.ToString , aby zwrócić ciąg Name studenta lub ciągu, który zawiera listę kursów ucznia.

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

Uwagi

ContentStringFormat może być wstępnie zdefiniowanym, złożonym lub niestandardowym formatem ciągu. Aby uzyskać więcej informacji na temat formatów ciągów, zobacz Formatting Types (Typy formatowania). Jeśli ustawisz ContentTemplate właściwość lub ContentTemplateSelector TabControl, ContentStringFormat właściwość zostanie zignorowana.