Partager via


Workbook.Colors, propriété

Obtient ou définit les couleurs de la palette pour le classeur.

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

Syntaxe

'Déclaration
ReadOnly Property Colors As Workbook_ColorsType
Workbook_ColorsType Colors { get; }

Valeur de propriété

Type : Microsoft.Office.Tools.Excel.Workbook_ColorsType
Valeur des couleurs RVB dans la palette de couleurs du classeur ou tableau contenant les 56 valeurs de couleurs RVB de la palette de couleurs du classeur.

Notes

La propriété Colors peut être utilisée avec le paramètre suivant.

Paramètre

Description

Index

Numéro d'index d'une couleur dans la palette de couleurs du classeur (de 1 à 56). Si cet argument n'est pas spécifié, cette propriété retourne un tableau qui contient la totalité des 56 couleurs de la palette.

Si vous essayez d'utiliser Colors sans spécifier de paramètres, Colors obtiendra un objet _ColorsType qui fait partie des outils de développement Office dans l'infrastructure Visual Studio et n'est pas conçu pour être utilisé directement à partir de votre code.

La palette du classeur a 56 entrées, chacune représentée par une valeur RVB.

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 utilise la propriété Colors pour affecter la couleur bleue à la première couleur de la palette de couleurs du classeur, puis affiche par programme la boîte de dialogue Palette de couleurs de Microsoft Office Excel pour vérifier que cette modification a été effectuée.

Cette version est destinée à un complément d'application.

Private Sub SetFirstColorInPalette()
    Dim vstoWorkbook As Workbook = Globals.Factory.GetVstoObject(Me.Application.ActiveWorkbook)
    vstoWorkbook.Colors(1) = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue)
    vstoWorkbook.Application.Dialogs( _
        Excel.XlBuiltInDialog.xlDialogColorPalette).Show()
End Sub
private void SetFirstColorInPalette()
{
    Workbook vstoWorkbook = Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook);
    vstoWorkbook.Colors[1] = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue);

    vstoWorkbook.Application.Dialogs[
        Excel.XlBuiltInDialog.xlDialogColorPalette].Show();
}

Sécurité .NET Framework

Voir aussi

Référence

Workbook Interface

Microsoft.Office.Tools.Excel, espace de noms