ChartSheetBase.ApplyLayout, méthode

Article
01/06/2014

Applique la mise en page spécifiée au graphique.

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

Syntaxe

'Déclaration
Public Sub ApplyLayout ( _
    layout As Integer, _
    chartType As Object _
)

public 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 du graphique inclus dans la feuille de graphique Chart1. 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, votre classeur doit contenir une feuille d'histogramme 2D groupé nommée Chart1.

Private Sub DesignChartSheet()
    Dim myChartSheet As Microsoft.Office.Tools.Excel.ChartSheet = _
        Globals.Chart1.Base

    myChartSheet.ApplyLayout(10)

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

private void DesignChartSheet()
{
    Microsoft.Office.Tools.Excel.ChartSheet myChartSheet  =
        Globals.Chart1.Base;

    myChartSheet.ApplyLayout(10, myChartSheet.ChartType);

    myChartSheet.SetElement(Microsoft.Office.Core.MsoChartElementType.
                       msoElementChartTitleCenteredOverlay);
    myChartSheet.SetElement(Microsoft.Office.Core.MsoChartElementType.
                       msoElementPrimaryCategoryAxisTitleHorizontal);
    myChartSheet.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

ChartSheetBase Classe

Microsoft.Office.Tools.Excel, espace de noms

Partager via