Workbook.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 (in Microsoft.Office.Tools.Excel.dll)
Syntax
'Declaration
ReadOnly Property Colors As Workbook_ColorsType
Get
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 _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.
Diese Version bezieht sich auf ein Add-In auf Anwendungsebene.
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(
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
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.