FormatSettings, énumération

Article
01/06/2014

Spécifie le type de mise en forme appliquée à ListObject lorsqu'il est lié aux données.

Cette énumération possède un attribut FlagsAttribute qui permet la combinaison d'opérations de bits de ses valeurs de membres.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
<FlagsAttribute> _
Public Enumeration FormatSettings

[FlagsAttribute]
public enum FormatSettings

Membres

	Nom de membre	Description
	Alignment	Indique s'il faut inclure un alignement dans le XlRangeAutoFormat prédéfini.
	Border	Indique s'il faut inclure des formats de bordure dans le XlRangeAutoFormat prédéfini.
	Font	Indique s'il faut inclure des formats de police dans le XlRangeAutoFormat prédéfini.
	Number	Indique s'il faut inclure des formats de nombre dans le XlRangeAutoFormat prédéfini.
	Pattern	Indique s'il faut inclure les formats de modèle dans le XlRangeAutoFormat prédéfini.
	Width	Indique s'il faut inclure la largeur de colonne et la hauteur de ligne dans le XlRangeAutoFormat prédéfini.

Notes

Six paramètres peuvent être combinés pour spécifier la mise en forme. À l'aide de cette énumération, vous pouvez sélectionner les paramètres à appliquer à ListObject. Par défaut, tous les paramètres de mise en forme sont appliqués.

Exemples

L'exemple de code suivant crée un DataTable et un ListObject, et lie ListObject à DataTable. Il applique ensuite les formats de police et de modèle d'une valeur XlRangeAutoFormat prédéfinie à ListObject.

Cet exemple illustre une personnalisation au niveau du document.

    Private Sub ListObject_DataBoundFormatSettings()
        ' Create a new DataSet and DataTable.
        Dim ds As New DataSet()
        Dim dt As DataTable = ds.Tables.Add("Customers")
        dt.Columns.Add(New DataColumn("LastName"))
        dt.Columns.Add(New DataColumn("FirstName"))

        ' Add a new row to the DataTable.
        Dim dr As DataRow = dt.NewRow()
        dr("LastName") = "Chan"
        dr("FirstName") = "Gareth"
        dt.Rows.Add(dr)

        ' Create a list object.
        Dim List1 As Microsoft.Office.Tools.Excel.ListObject = _
            Me.Controls.AddListObject(Me.Range( _
            "A1"), "List1")

        ' Bind the list object to the DataTable.
        List1.AutoSetDataBoundColumnHeaders = True
        List1.SetDataBinding(ds, "Customers", _
            "LastName", "FirstName")

        ' Specify the format settings that you want to include.
        ' In this example, only the Font and Pattern 
        ' settings are applied.
        List1.DataBoundFormatSettings = _
            Microsoft.Office.Tools.Excel.FormatSettings.Font Or _
            Microsoft.Office.Tools.Excel.FormatSettings.Pattern

        ' Add a format to the list object.
        List1.DataBoundFormat = _
            Excel.XlRangeAutoFormat.xlRangeAutoFormatList2

    End Sub

private void ListObject_DataBoundFormatSettings()
{
    // Create a new DataSet and DataTable.
    DataSet ds = new DataSet();
    DataTable dt = ds.Tables.Add("Customers");
    dt.Columns.Add(new DataColumn("LastName"));
    dt.Columns.Add(new DataColumn("FirstName"));

    // Add a new row to the DataTable.
    DataRow dr = dt.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    dt.Rows.Add(dr);

    // Create a list object.
    Microsoft.Office.Tools.Excel.ListObject list1 = 
        this.Controls.AddListObject(
        this.Range["A1"], "list1");

    // Bind the list object to the DataTable.
    list1.AutoSetDataBoundColumnHeaders = true;
    list1.SetDataBinding(ds, "Customers", "LastName",
        "FirstName");

    // Specify the format settings that you want to include.
    // In this example, only the Font and Pattern 
    // settings are applied.
    list1.DataBoundFormatSettings =
        Microsoft.Office.Tools.Excel.FormatSettings.Font |
        Microsoft.Office.Tools.Excel.FormatSettings.Pattern;

    // Add a format to the list object.
    list1.DataBoundFormat = 
        Excel.XlRangeAutoFormat.xlRangeAutoFormatList2;
}

Voir aussi

Référence

Microsoft.Office.Tools.Excel, espace de noms

Partager via