Freigeben über


WorkbookBase.Colors-Eigenschaft

Ruft Farben in der Palette für die Arbeitsmappe ab oder legt diese fest.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
Public ReadOnly Property Colors As Workbook_ColorsType
    Get
public Workbook_ColorsType Colors { get; }

Eigenschaftswert

Typ: Microsoft.Office.Tools.Excel.Workbook_ColorsType
Ein RGB-Farbwert in der Farbpalette für die Arbeitsmappe oder ein Array, das alle 56 RGB-Farbwerte in der Farbpalette für die Arbeitsmappe enthält.

Hinweise

Die Colors-Eigenschaft kann mit dem folgenden Parameter verwendet werden.

Parameter

Beschreibungen

Index

Die Indexnummer einer Farbe in der Farbpalette für die Arbeitsmappe (von 1 bis 56). Wenn dieses Argument nicht angegeben ist, gibt diese Eigenschaft ein Array zurück, das alle 56 Farben in der Palette enthält.

Wenn Sie Colors ohne Angabe von Parametern verwenden, ruft Colors ein Workbook_ColorsType-Objekt ab, das Teil der Office-Entwicklungstools in der Visual Studio-Infrastruktur ist und nicht für die direkte Verwendung im Code vorgesehen ist.

Die Palette für die Arbeitsmappe besitzt 56 Einträge, die jeweils durch einen RGB-Wert dargestellt werden.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird mithilfe der Colors-Eigenschaft Blau als erste Farbe in der Farbpalette der Arbeitsmappe festgelegt, und dann wird das Dialogfeld Color Palette (Farbpalette) von Microsoft Office Excel programmgesteuert angezeigt, um zu überprüfen, ob die Änderung vorgenommen wurde.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub SetFirstColorInPalette()
    Me.Colors(1) = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue)
    Me.Application.Dialogs( _
        Excel.XlBuiltInDialog.xlDialogColorPalette).Show()
End Sub
private void SetFirstColorInPalette()
{
    this.Colors[1] = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue);

    this.Application.Dialogs[
        Excel.XlBuiltInDialog.xlDialogColorPalette].Show(
        missing, missing, missing, missing, missing, missing,
        missing, missing, missing, missing, missing, missing,
        missing, missing, missing, missing, missing, missing,
        missing, missing, missing, missing, missing, missing,
        missing, missing, missing, missing, missing, missing);
}

.NET Framework-Sicherheit

Siehe auch

Referenz

WorkbookBase Klasse

Microsoft.Office.Tools.Excel-Namespace