Chart.ApplyLayout(Int32, Object) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public void ApplyLayout (int Layout, object ChartType);

abstract member ApplyLayout : int * obj -> unit

Public Sub ApplyLayout (Layout As Integer, Optional ChartType As Object)

Paramètres

Layout: Int32

Entier de 1 à 10 qui spécifie le type de mise en page à appliquer au graphique.

ChartType: Object

Une des valeurs de l'objet XlChartType.

Exemples

L’exemple de code suivant applique la dixième disposition disponible pour le type de graphique du Chart_1 graphique. En outre, l’exemple utilise la SetElement méthode pour appliquer d’autres modifications de disposition : définition du style du titre du graphique pour qu’il soit centré et situé à l’intérieur de la zone de grille du graphique, ajout d’un titre pour l’axe horizontal et ajout d’un titre pivoté pour l’axe vertical. Pour exécuter cet exemple de code, vous devez ajouter un graphique en deux dimensions en colonnes cluster avec le nom Chart_1 à la feuille Sheet1par défaut .

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);
}

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

Remarques

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

Chaque type de graphique a son propre ensemble d’options de disposition. Par exemple, les options de disposition d’un graphique en secteurs sont différentes des options de disposition d’un histogramme. Si vous souhaitez appliquer une disposition à partir d’un autre type de graphique, vous pouvez utiliser le ChartType paramètre pour spécifier le type de graphique auquel le Layout paramètre fera référence. Par exemple, si vous avez un histogramme et que vous souhaitez appliquer une disposition à partir d’un graphique en courbes, transmettez la Microsoft.Office.Interop.Excel.XlChartType.xlLine valeur au ChartType paramètre . La disposition ajoute uniquement les éléments de graphique disponibles pour ce type de graphique particulier.

Paramètres facultatifs

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

S’applique à

Partager via