Propriedade WorkbookBase.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.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public ReadOnly Property Colors As Workbook_ColorsType
    Get

public 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 Workbook_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.

Este exemplo é para uma personalização em 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(
        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

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via