TabControl.ContentStringFormat 属性

定义

命名空间:

System.Windows.Controls

程序集:

PresentationFramework.dll

获取一个撰写字符串，该字符串指定如果 TabItem 对象的内容显示为字符串，应如何设置这些内容的格式。

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

属性值

String

一个撰写字符串，指定如果 TabItem 对象的内容显示为字符串，应如何设置这些内容的格式。

示例

以下示例将 a TabControl 绑定到对象的集合 Student 。 该 Student 类具有属性 Name 、对象集合 Course ，并实现 IFormattable.ToString 返回学生或列出学生课程的字符串的方法 Name 。 该示例用于HeaderedContentControl.HeaderStringFormat将学生的姓名Header放在继承自HeaderedContentControl) 的每个TabItem (中，以及ContentStringFormat显示每个学生在内容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>

以下示例实现 IFormattable.ToString 返回学生或 Name 列出学生课程的字符串的方法。

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

注解

ContentStringFormat 可以是预定义、复合或自定义字符串格式。 有关字符串格式的详细信息，请参阅 格式设置类型。 如果设置或ContentTemplateContentTemplateSelector设置，TabControl则ContentStringFormat忽略该属性。