Propriedade Workbook.Colors

Artigo
05/21/2013

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

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

Sintaxe

'Declaração
ReadOnly Property Colors As Workbook_ColorsType

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 retornará uma matriz que contém todos os 56 cores em paleta.

Se você tentar usar Colors sem especificar quaisquer parâmetros, Colors obterá um objeto de _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 uma é 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 a seguir 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.

Esta versão é para um suplemento ao aplicativo.

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

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áveis.

Consulte também

Referência

Workbook Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via