TabControl.ContentStringFormat Propriété

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtient ou définit une chaîne composite qui spécifie la manière de mettre en forme le contenu des objets TabItem s'ils sont affichés en tant que chaînes.

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

Valeur de propriété

String

Chaîne composite qui spécifie la manière de mettre en forme le contenu des objets TabItem s'ils sont affichés en tant que chaînes.

Exemples

L’exemple suivant lie une TabControl collection d’objets Student . La Student classe a une propriété, une Name collection d’objets Course et implémente la IFormattable.ToString méthode pour renvoyer l’étudiant Name ou une chaîne qui répertorie les cours de l’étudiant. L’exemple utilise HeaderedContentControl.HeaderStringFormat pour placer le nom d’un étudiant dans chaque TabItem Header (qui hérite de HeaderedContentControl), et pour ContentStringFormat afficher la liste des cours pour chaque étudiant dans le contenu du 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>

L’exemple suivant implémente la méthode pour renvoyer l’étudiant IFormattable.ToString Name ou une chaîne qui répertorie les cours de l’étudiant.

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

Remarques

ContentStringFormat peut être un format de chaîne prédéfini, composite ou personnalisé. Pour plus d’informations sur les formats de chaîne, consultez Types de mise en forme. Si vous définissez le ContentTemplate ou ContentTemplateSelector d’un TabControl, la ContentStringFormat propriété est ignorée.