スタイル

Alignment はセルの配置設定を直接マップします。

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

Border はセルの境界線設定を直接マップします。

type Border struct {
    Type  string
    Color string
    Style int
}

Font は直接フォントのフォント設定をマッピングします。

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 はセルの塗りつぶし設定を直接マップします。

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

Protection は、セルの保護設定を直接マップします。

type Protection struct {
    Hidden bool
    Locked bool
}

Style は、セルのスタイル設定を直接マップします。

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

スタイルの作成

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

NewStyle は、指定されたスタイル オプションによってセルのスタイルを作成する関数を提供し、スタイル インデックスを返します。同じスタイル インデックスを異なるワークブック間で使用することはできません。この関数は同時実行性が安全です。Font.Color フィールドでは、RRGGBB 16 進表記で表される RGB カラーが使用されることに注意してください。

枠

次の表は、excelize でサポートされている Border.Type で使用される境界線の種類を示しています:

次の表は、excelize インデックス番号でサポートされている Border.Style で使用される境界線スタイルを示しています:

インデックス	スタイル	ライン	プレビュー
0	なし	0
1	継続的	1
2	継続的	2
3	ダッシュ	1
4	ドット	1
5	継続的	3
6	ダブル	3
7	継続的	0
8	ダッシュ	2
9	ダッシュ ドット	1
10	ダッシュ ドット	2
11	ダッシュ ドット ドット	1
12	ダッシュ ドット ドット	2
13	スラントダッシュドット	2

次の表は、Border.Style で使用されるボーダー線スタイルを Excel ダイアログに表示される順序で示しています:

インデックス	プレビュー	インデックス	プレビュー
0		12
7		13
4		10
11		8
9		2
3		5
1		6

塗りつぶしの種類

Fill.Type は塗りつぶしの種類を設定するために使用します。サポートされている種類は gradient または pattern です。gradient の塗りつぶしを設定する場合、有効な Fill.Shading 値を指定し、Fill.Color は有効な色値を 2 つ含む配列である必要があります。pattern の塗りつぶしを設定する場合、有効な Fill.Pattern 値を指定し、Fill.Color は有効な色値を 1 つ含む配列である必要があります。SetCellStyle の例も参照してください。

色塗り

次の表は、excelize インデックス番号でサポートされている Fill.Shading で使用されるシェーディング スタイルを示しています:

パターン塗りつぶし

次の表は、excelize インデックス番号でサポートされている Fill.Pattern で使用されるパターン スタイルを示しています:

インデックス	スタイル	インデックス	スタイル
0	なし	10
1		11
2		12
3		13
4		14
5		15
6		16
7		17
8		18
9

透明度

Fill.Transparency は、グラフと図形の透明度を設定するためにのみ使用し、セルには使用しません。値は 0 から 100 までの数値で、それぞれ 0% から 100% を表します。デフォルト値は 0 で、完全に不透明（透明ではない）を表します。

アライメント

インデント

Indent は整数値で、1 ずつ増分すると 3 つのスペースを表します。セル内のテキストのインデントの (通常のスタイル フォントの) スペースの数を示します。インデントするスペースの数は次のように計算されます。

インデントするスペースの数 = インデント値 * 3

たとえば、インデント値 1 は、テキストがセルの端から (通常のスタイルのフォントの) 3 スペース幅で始まることを意味します。注: 1 つのスペース文字の幅はフォントによって定義されます。左揃え、右揃え、および分散水平揃えのみがサポートされています。

水平方向の位置合わせ

次の表は、Alignment.Horizontal で使用されるセルの水平方向の配置の種類を示しています:

垂直方向の位置合わせ

次の表は、Alignment.Vertical で使用されるセルの垂直方向の配置の種類を示しています:

読む順番

ReadingOrder は、セルの読み取り順序が左から右、右から左、またはコンテキスト依存のいずれであるかを示す uint64 値です。 このフィールドの有効な値は次のとおりです。

相対インデント

RelativeIndent は、セル内のテキストを調整するためのインデントの追加スペース数を示す整数値です。

フォントの下線

次の表は、Font.Underline で使用されるフォントの下線スタイルのタイプを示しています:

デジタルカスタムフォーマット

Excel の組み込みのすべての言語形式 (Style.NumFmt フィールド) を次の表に示します:

繁体字中国語の数値形式

zh-tw 言語の数値形式コード:

簡体字中国語の数値形式

zh-cn 言語の数値形式コード:

日本語の番号形式

ja-jp 言語の数字形式コード:

韓国語番号形式

ko-kr 言語の数値形式コード:

タイ語の言語番号形式

th-th 言語のコードの数値形式:

通貨形式

組み込みの通貨形式を Excelize は次の表に示し、次の表でこれらの型のみをサポートします (インデックス番号はマークアップにのみ使用され、Excel ファイル内では使用されず、GetCellValue 現在の関数では書式設定された値を取得できません):

セルのサポート セットカスタム番号形式を Excel 化します。たとえば、Sheet1!A6 のウルグアイ (スペイン語) 形式で日付タイプとして数値を設定します:

f := excelize.NewFile()
defer func() {
    if err := f.Close(); err != nil {
        fmt.Println(err)
    }
}()
if err := f.SetCellValue("Sheet1", "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("Sheet1", "A6", "A6", style)

Excel アプリケーションのセル Sheet1!A6: martes, 04 de Julio de 2017

スタイルを取得

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

GetStyle は、指定されたスタイル インデックスによってスタイル定義を取得する関数を提供します。

列のスタイル設定

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

SetColStyle は、指定されたワークシート名、列範囲、およびスタイル ID によって列のスタイルを設定する関数を提供します。これにより、列の既存のスタイルが上書きされ、スタイルが既存のスタイルに追加またはマージされないことに注意してください。この関数は、同時実行セーフをサポートします。

たとえば、Sheet1 の列 H のスタイルを設定します。

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

Sheet1 の列 C:F のスタイルを設定します:

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

列のスタイルを取得する

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

GetColStyle には、指定されたワークシート名と列名によって列スタイル ID を取得する関数が用意されています。この関数は、同時実行セーフをサポートします。

行スタイルを設定する

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

SetRowStyle は、指定されたワークシート名、行範囲、およびスタイル ID によって行のスタイルを設定する関数を提供します。これにより、行の既存のスタイルが上書きされ、スタイルが既存のスタイルに追加またはマージされないことに注意してください。

たとえば、Sheet1 の行1のスタイルを設定します:

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

Sheet1 の行1から10のスタイルを設定します:

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

既定のフォントを設定する

func (f *File) SetDefaultFont(fontName string)

SetDefaultFont は、ブック内の既定のフォントを変更します。

デフォルトのフォントを取得する

func (f *File) GetDefaultFont() string

GetDefaultFont は、ブックに現在設定されているデフォルトのフォント名を提供します。Excelize のデフォルトフォントによって生成されるスプレッドシートは Calibri です。