Propriedade WorkbookBase.Colors

Artigo
01/09/2014

Obtém ou define cores em paleta para a pasta de trabalho.

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

Sintaxe

'Declaração
Public ReadOnly Property Colors As Workbook_ColorsType

public Workbook_ColorsType Colors { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Excel.Workbook_ColorsType
Um valor de cor RGB em paleta de cores para a pasta de trabalho, ou uma matriz que contém todos os 56 valores de cor RGB em paleta de cores para a pasta de trabalho.

Comentários

A propriedade de Colors pode ser usada com o parâmetro a seguir.

Parâmetro	Descrição
Index	O índice de uma cor em paleta de cores de pasta de trabalho (de 1 a 56). Se esse argumento não for especificado, essa propriedade retorna uma matriz que contém todos os 56 de cores em paleta.

Se você tentar usar Colors sem especificar quaisquer parâmetros, Colors obterá um objeto de Workbook_ColorsType que é parte das ferramentas de desenvolvimento do Office na infraestrutura do Visual Studio e não destina-se a ser usado diretamente do seu código.

A paleta de pasta de trabalho tem 56 entradas, cada um representada por um valor de RGB.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código usa a propriedade de Colors para definir a primeira cor de paleta de cores de pasta de trabalho para azul e em seguida, exibe programaticamente a caixa de diálogo Microsoft Office Excel Paleta de Cores para verificar que essa alteração é feita.

Este exemplo destina-se a uma personalização no nível de documento.

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();
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via