Estilo

Alignment mapeia diretamente as configurações de alinhamento das células.

type Alignment struct {
    Horizontal      string
    Indent          int
    JustifyLastLine bool
    ReadingOrder    uint64
    RelativeIndent  int
    ShrinkToFit     bool
    TextRotation    int
    Vertical        string
    WrapText        bool
}

Border mapeia diretamente as configurações de borda das células.

type Border struct {
    Type  string
    Color string
    Style int
}

Font mapeia diretamente as configurações de fonte das fontes.

type Font struct {
    Bold         bool
    Italic       bool
    Underline    string
    Family       string
    Size         float64
    Strike       bool
    Color        string
    ColorIndexed int
    ColorTheme   *int
    ColorTint    float64
    VertAlign    string
}

Fill mapeia diretamente as configurações de preenchimento das células.

type Fill struct {
    Type         string
    Pattern      int
    Color        []string
    Shading      int
    Transparency int
}

Protection mapeia diretamente as configurações de proteção das células.

type Protection struct {
    Hidden bool
    Locked bool
}

Style mapeia diretamente as configurações de estilo das células.

type Style struct {
    Border        []Border
    Fill          Fill
    Font          *Font
    Alignment     *Alignment
    Protection    *Protection
    NumFmt        int
    DecimalPlaces int
    CustomNumFmt  *string
    NegRed        bool
}

Criar estilo

func (f *File) NewStyle(style *Style) (int, error)

NewStyle fornece uma função para criar o estilo para células por meio de determinadas opções de estilo e retorna o índice de estilo. O mesmo índice de estilo não pode ser usado em pastas de trabalho diferentes. Esta função é segura para simultaneidade. Observe que o campo Font.Color usa uma cor hexadecimal representada em notação hexadecimal RRGGBB.

Fronteira

A tabela a seguir mostra os tipos de borda usados em Border.Type suportados pelo Excelize:

A tabela a seguir mostra os estilos de borda usados em Border.Style suportados pelo número de índice do Excelize:

Índice	Estilo	Linha	Visualização
0	Nenhum	0
1	Contínuo	1
2	Contínuo	2
3	Tracejada	1
4	Ponto	1
5	Contínuo	3
6	Double	3
7	Contínuo	0
8	Tracejada	2
9	Tracejada Ponto	1
10	Tracejada Ponto	2
11	Tracejada Ponto Ponto	1
12	Tracejada Ponto Ponto	2
13	SlantDash Ponto	2

A tabela a seguir mostra os estilos de borda usados em Border.Style na ordem mostrada na caixa de diálogo do Excel:

Índice	Visualização	Índice	Preview
0		12
7		13
4		10
11		8
9		2
3		5
1		6

Tipo de preenchimento

O Fill.Type é usado para definir o tipo de preenchimento; os tipos suportados são gradient ou pattern. Ao configurar um preenchimento do tipo gradient, um valor válido de Fill.Shading deve ser fornecido, e Fill.Color deve ser uma matriz contendo exatamente dois valores de cor válidos. Ao configurar um preenchimento do tipo pattern, um valor válido de Fill.Pattern deve ser fornecido, e Fill.Color deve ser uma matriz contendo exatamente um valor de cor válido. Consulte também os exemplos em SetCellStyle.

Preenchimento de cor

A tabela a seguir mostra os estilos de sombreamento usados em Fill.Shading suportados pelo número de índice do Excelize:

Preenchimento de padrão

A tabela a seguir mostra os estilos de padrão usados em Fill.Pattern suportados pelo número de índice do Excelize:

Índice	Estilo	Índice	Estilo
0	Nenhum	10
1		11
2		12
3		13
4		14
5		15
6		16
7		17
8		18
9

Transparência

A função Fill.Transparency é usada apenas para definir a transparência do gráfico e da forma, não sendo usada para células. O valor deve ser um número de 0 a 100, que representa de 0% a 100%. O valor padrão é 0, representando opacidade total (não transparente).

Alinhamento

Recuar

O Indent é um valor inteiro, onde um incremento de 1 representa 3 espaços. Indica o número de espaços (da fonte de estilo normal) de recuo do texto em uma célula. O número de espaços a recuar é calculado da seguinte forma:

Número de espaços para recuar = valor de recuo * 3

Por exemplo, um valor de recuo 1 significa que o texto começa a 3 larguras de espaço (da fonte de estilo normal) a partir da borda da célula. Nota: A largura de um caractere de espaço é definida pela fonte. Somente alinhamentos horizontais esquerdo, direito e distribuído são suportados.

Alinhamento horizontal

A tabela a seguir mostra o tipo de alinhamento horizontal das células usado em Alignment.Horizontal:

Alinhamento vertical

A tabela a seguir mostra o tipo de alinhamento vertical das células usado em Alignment.Vertical:

Ordem de leitura

ReadingOrder é um valor uint64 que indica se a ordem de leitura da célula é da esquerda para a direita, da direita para a esquerda ou depende do contexto. o valor válido deste campo era:

Recuo relativo

RelativeIndent é um valor inteiro para indicar o número adicional de espaços de recuo para ajustar o texto em uma célula.

Sublinhado da fonte

A tabela a seguir mostra o tipo de estilo de sublinhado de fonte usado em Font.Underline:

Formato numérico

Os formatos integrados de todos os idiomas do Excel (o campo Style.NumFmt) são mostrados na tabela a seguir:

Formato numérico chinês tradicional

Código de formato numérico na linguagem zh-tw:

Formato numérico chinês simplificado

Código de formato numérico na linguagem zh-cn:

Formato numérico japonês

Código de formato numérico na linguagem ja-jp:

Formato numérico coreano

Código de formato numérico na linguagem ko-kr:

Formato numérico do idioma tailandês

Código de formato numérico na linguagem th-th:

Formato de moeda

Os formatos de moeda integrados do Excelize são mostrados na tabela a seguir, suportam apenas esses tipos na tabela a seguir (o número do índice é usado apenas para marcação e não é usado dentro de um arquivo Excel e você não pode obter o valor formatado pela função GetCellValue) atualmente:

Excelize suporta definir formato de número personalizado para célula. Por exemplo, defina o número como tipo de data no formato Uruguai (espanhol) para Planilha1!A6:

f := excelize.NewFile()
defer func() {
    if err := f.Close(); err != nil {
        fmt.Println(err)
    }
}()
if err := f.SetSheetName("Sheet1", "Planilha1"); err != nil {
    fmt.Println(err)
    return
}
if err := f.SetCellValue("Planilha1", "A6", 42920.5); err != nil {
    fmt.Println(err)
    return
}
exp := "[$-380A]dddd\\,\\ dd\" de \"mmmm\" de \"yyyy;@"
style, err := f.NewStyle(&excelize.Style{CustomNumFmt: &exp})
if err != nil {
    fmt.Println(err)
    return
}
err = f.SetCellStyle("Planilha1", "A6", "A6", style)

Célula Planilha1!A6 no Aplicativo Excel: martes, 04 de Julio de 2017

Obtenha estilo

func (f *File) GetStyle(idx int) (*Style, error)

GetStyle fornece uma função para obter definição de estilo por determinado índice de estilo.

Definir estilo de coluna

func (f *File) SetColStyle(sheet, columns string, styleID int) error

SetColStyle fornece uma função para definir o estilo das colunas por determinado nome da planilha, intervalo de colunas e ID do estilo. Esta função é segura para simultaneidade. Observe que isso substituirá os estilos existentes nas colunas e não acrescentará ou mesclará o estilo com os estilos existentes.

Por exemplo, defina o estilo da coluna H em Planilha1:

err = f.SetColStyle("Planilha1", "H", style)

Defina o estilo das colunas C:F na Planilha1:

err = f.SetColStyle("Planilha1", "C:F", style)

Obter estilo de coluna

func (f *File) GetColStyle(sheet, col string) (int, error)

GetColStyle fornece uma função para obter o ID do estilo da coluna por determinado nome da planilha e nome da coluna. Esta função é segura para simultaneidade.

Definir estilo de linha

func (f *File) SetRowStyle(sheet string, start, end, styleID int) error

SetRowStyle fornece uma função para definir o estilo das linhas por determinado nome da planilha, intervalo de linhas e ID do estilo. Observe que isso substituirá os estilos existentes nas linhas, mas não acrescentará ou mesclará o estilo com os estilos existentes.

Por exemplo, defina o estilo da linha 1 em Planilha1:

err := f.SetRowStyle("Planilha1", 1, 1, styleID)

Defina o estilo das linhas 1 a 10 em Planilha1:

err := f.SetRowStyle("Planilha1", 1, 10, styleID)

Definir fonte padrão

func (f *File) SetDefaultFont(fontName string)

SetDefaultFont altera a fonte padrão na pasta de trabalho.

Obter fonte padrão

func (f *File) GetDefaultFont() string

GetDefaultFont fornece o nome da fonte padrão atualmente definido na pasta de trabalho. A planilha gerada pela fonte padrão do Excelize é Calibri.