Workbook.Colors (Propiedad)
Obtiene o establece colores en la paleta del libro.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
ReadOnly Property Colors As Workbook_ColorsType
Get
Workbook_ColorsType Colors { get; }
Valor de propiedad
Tipo: Microsoft.Office.Tools.Excel.Workbook_ColorsType
Valor de color RGB en la paleta de colores del libro o una matriz que contiene los 56 valores de color RGB de la paleta de colores del libro.
Comentarios
La propiedad Colors se puede utilizar con el parámetro siguiente.
Parámetro |
Descripción |
|---|---|
Index |
El número de índice de un color en la paleta de colores del libro (de 1 a 56). Si no se especifica este argumento, esta propiedad devuelve una matriz que contiene los 56 colores de la paleta. |
Si intenta usar Colors sin especificar parámetros, Colors obtendrá un objeto _ColorsType que forma parte de la infraestructura de las herramientas de desarrollo de Office en Visual Studio y que no está diseñado para usarlo directamente en el código.
La paleta del libro tiene 56 entradas, representadas por un valor RGB.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente utiliza la propiedad Colors para establecer el primer color de la paleta de colores del libro en azul y, a continuación, muestra mediante programación el cuadro de diálogo Paleta de colores de Microsoft Office Excel para comprobar que se ha realizado el cambio.
Se trata de una versión para un complemento en el nivel de la aplicación.
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);
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.