Chart.SetElement, méthode

Article
01/06/2014

Modifie un élément sur le graphique.

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

Syntaxe

'Déclaration
Sub SetElement ( _
    Element As MsoChartElementType _
)

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 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