Chart.ApplyLayout, méthode

Article
01/06/2014

Applique les mises en page affichées sur le ruban.

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

Syntaxe

'Déclaration
Sub ApplyLayout ( _
    Layout As Integer, _
    ChartType As Object _
)

void ApplyLayout(
    int Layout,
    Object ChartType
)

Paramètres

Layout
Type : System.Int32
Entier de 1 à 10 qui spécifie le type de mise en page à appliquer au graphique.

ChartType
Type : System.Object
Une des valeurs de Microsoft.Office.Interop.Excel.XlChartType.

Notes

Les valeurs du paramètre Layout correspondent aux options disponibles dans le groupe Dispositions du graphique sous l'onglet Création du le ruban. L'onglet Création est disponible lorsque vous sélectionnez un graphique.

Chaque type de graphique a son propre jeu d'options de mise en page. Par exemple, les options de mise en page pour un graphique à secteurs sont différentes des options de mise en page pour un histogramme. Si vous souhaitez appliquer une mise en page d'un type de graphique différent, vous pouvez utiliser le paramètre ChartType pour spécifier le type de graphique à qui le paramètre Layout fera référence. Par exemple, si vous avez un histogramme et que vous souhaitez appliquer une mise en page d'un graphique en courbes, passez la valeur XlChartType.xlLine au paramètre ChartType. La mise en page ajoute seulement des éléments de graphique qui sont disponibles pour ce type de graphique particulier.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant applique la dixième disposition disponible pour le type de graphique du graphique Chart_1. Par ailleurs, l'exemple utilise la méthode SetElement pour appliquer d'autres changements de disposition : définir le style du titre du graphique pour qu'il soit centré et qu'il se trouve à l'intérieur de la grille du graphique, ajouter un titre pour l'axe horizontal et ajouter un titre pivoté pour l'axe vertical. Pour exécuter cet exemple de code, vous devez ajouter un histogramme 2D groupé portant le nom Chart_1 à la feuille par défaut Sheet1.

Private Sub DesignChart()
    Dim myChart As Microsoft.Office.Tools.Excel.Chart = _
        Globals.Sheet1.Chart_1

    myChart.ApplyLayout(10)

    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementChartTitleCenteredOverlay)
    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementPrimaryCategoryAxisTitleHorizontal)
    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementPrimaryValueAxisTitleRotated)
End Sub

private void DesignChart()
{
    Microsoft.Office.Tools.Excel.Chart myChart =
        Globals.Sheet1.Chart_1;

    myChart.ApplyLayout(10, myChart.ChartType);

    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementChartTitleCenteredOverlay);
    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementPrimaryCategoryAxisTitleHorizontal);
    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementPrimaryValueAxisTitleRotated);
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

Chart Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via