HeaderedContentControl.HeaderStringFormat HeaderedContentControl.HeaderStringFormat HeaderedContentControl.HeaderStringFormat HeaderedContentControl.HeaderStringFormat Property

Definición

Obtiene o establece una cadena compuesta que especifica cómo se aplica formato a la propiedad Header si se muestra como una cadena.Gets or sets a composite string that specifies how to format the Header property if it is displayed as a string.

public:
 property System::String ^ HeaderStringFormat { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string HeaderStringFormat { get; set; }
member this.HeaderStringFormat : string with get, set
Public Property HeaderStringFormat As String

Valor de propiedad

Cadena compuesta que especifica cómo se aplica formato a la propiedad Header si se muestra como una cadena.A composite string that specifies how to format the Header property if it is displayed as a string. De manera predeterminada, es null.The default is null.

Ejemplos

En el ejemplo siguiente se enlaza un TabControl a una colección de Student objetos.The following example binds a TabControl to a collection of Student objects. El Student clase tiene un 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 se muestra los cursos del alumno.The Student class has a Name property, a collection of Course objects, and implements the IFormattable.ToString method to return either the Name of the student or a string that lists the student's courses. El ejemplo se utiliza HeaderStringFormat para poner el nombre de un estudiante la Header de cada TabItem (que hereda de HeaderedContentControl) y el TabControl.ContentStringFormat para mostrar la lista de cursos de cada estudiante en el contenido de la TabItem.The example uses HeaderStringFormat to put a student's name in the Header of each TabItem (which inherits from HeaderedContentControl), and the TabControl.ContentStringFormat to display the course list for each student in the Content of the 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 se muestra los cursos del alumno.The following example implements the IFormattable.ToString method to return either the Name of the student or a string that lists the student's courses.

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.HeaderStringFormat can be a predefined, composite, or custom string format. Para obtener más información acerca de los formatos de cadena, vea aplicar formato a tipos.For more information about string formats, see Formatting Types. Si establece la HeaderTemplate o HeaderTemplateSelector propiedad de un HeaderedContentControl, el HeaderStringFormat se omite.If you set the HeaderTemplate or HeaderTemplateSelector property of a HeaderedContentControl, the HeaderStringFormat property is ignored.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field HeaderStringFormatProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true NoneNone

Se aplica a