Propriedade Workbook.Colors

Artigo
08/01/2011

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

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

Sintaxe

'Declaração
ReadOnly Property Colors As Workbook_ColorsType
    Get

Workbook_ColorsType Colors { get; }

Valor de propriedade

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

Comentários

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

Parameter	Description
Index	O número de índice de uma cor na paleta de cores do trabalho (de 1 a 56). Se esse argumento não for especificado, essa propriedade retorna uma matriz que contém todas as 56 cores na paleta.

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

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

Optional Parameters

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

Exemplos

O seguinte exemplo de código usa a Colors propriedade para definir a primeira cor na paleta de cores da pasta de trabalho como azul e exibe programaticamente o Excel de Microsoft Office Paleta de cores caixa de diálogo para verificar se essa alteração foi feita.

Esta versão é um suplemento em nível de 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(
        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);
}

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