HeaderedContentControl.HeaderStringFormat Propiedad

Definición

Espacio de nombres:

System.Windows.Controls

Ensamblado:

PresentationFramework.dll

Obtiene o establece una cadena compuesta que especifica cómo se aplica formato a la propiedad Header si se muestra como una cadena.

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

Valor de propiedad

String

Cadena compuesta que especifica cómo se aplica formato a la propiedad Header si se muestra como una cadena. De manera predeterminada, es null.

Atributos

BindableAttribute

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 HeaderStringFormat para colocar el nombre de un alumno en de Header cada TabItem uno (que hereda de HeaderedContentControl) y para TabControl.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

HeaderStringFormat puede ser un formato de cadena predefinido, compuesto o personalizado. Para obtener más información sobre los formatos de cadena, vea Tipos de formato. Si establece la HeaderTemplate propiedad o HeaderTemplateSelector de , HeaderedContentControlse omite la HeaderStringFormat propiedad .

Información sobre propiedades de dependencia

Campo identificador	HeaderStringFormatProperty
Propiedades de metadatos establecidas en true	None