TabControl.ContentStringFormat Propiedad

Definición

Espacio de nombres:

System.Windows.Controls

Ensamblado:

PresentationFramework.dll

Obtiene una cadena compuesta que especifica cómo se aplica formato al contenido de los objetos TabItem si se muestran como cadenas.

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

Valor de propiedad

String

Cadena compuesta que especifica cómo se aplica formato al contenido de los objetos TabItem si se muestran como cadenas.

Ejemplos

En el ejemplo siguiente se enlaza un TabControl objeto a una colección de Student objetos . La Student clase tiene una Name propiedad, una colección de Course objetos e implementa el IFormattable.ToString método para devolver el Name del alumno o una cadena que enumera los cursos del alumno. En el ejemplo se usa HeaderedContentControl.HeaderStringFormat para colocar el nombre de un alumno en Header de cada TabItem uno (que hereda de HeaderedContentControl) y para ContentStringFormat mostrar la lista de cursos de cada alumno en el Contenido de 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>

En el ejemplo siguiente se implementa el IFormattable.ToString método para devolver el Name del alumno o una cadena que enumera los cursos del alumno.

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

Comentarios

ContentStringFormat puede ser un formato de cadena predefinido, compuesto o personalizado. Para obtener más información sobre los formatos de cadena, vea Aplicar formato a tipos. Si establece o ContentTemplate ContentTemplateSelector de , TabControlse omite la ContentStringFormat propiedad .