ChartSheetBase.SetElement, méthode

Article
01/06/2014

Modifie un élément sur le graphique affiché sur le ChartSheetBase.

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 SetElement ( _
    element As MsoChartElementType _
)

public void SetElement(
    MsoChartElementType element
)

Paramètres

element
Type : Microsoft.Office.Core.MsoChartElementType
Une des valeurs Microsoft.Office.Core.MsoChartElementType qui spécifie le type de modification d'élément.

Notes

Utilisez la méthode SetElement pour modifier un élément du graphique d'après les options spécifiée par les valeurs Microsoft.Office.Core.MsoChartElementType. Par exemple, pour masquer la légende du tableau, passez la valeur Microsoft.Office.Core.MsoChartElementType.msoElementLegendNone à la méthode SetElement.

Les opérations que vous pouvez exécuter en utilisant cette méthode correspondent aux boutons suivants sur l'onglet Disposition du ruban lorsqu'un graphique est sélectionné :

Tous les boutons dans le groupe Étiquettes.
Tous les boutons dans le groupe Axes.
Tous les boutons dans le groupe Analyse.
Boutons Zone de traçage, Paroi du graphique et Plancher de graphique dans le groupe Arrière-plan.

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