工具函式

《Excelize 權威指南》圖書出版，網路購買方式：人民郵電出版社 | 異步社區 | 天貓 | 京東 | 當當 | 亞馬遜 | 微店 | 抖音

ZipWriter 定義了一個用於將檔案寫入 ZIP 壓縮包的介面。它提供了在壓縮包中建立新檔案、從檔案系統新增檔案以及在寫入完成後關閉壓縮包的方法。

type ZipWriter interface {
    Create(name string) (io.Writer, error)
    AddFS(fsys fs.FS) error
    Close() error
}

創建表格

func (f *File) AddTable(sheet string, table *Table) error

根據給定的工作表名、儲存格坐標區域和條件式格式創建表格。

例1，在名為 Sheet1 的工作表 A1:D5 區域創建表格：

err := f.AddTable("Sheet1", &excelize.Table{Range: "A1:D5"})

例2，在名為 Sheet2 的工作表 F2:H6 區域創建帶有條件式格式的表格：

disable := false
err := f.AddTable("Sheet2", &excelize.Table{
    Range:             "F2:H6",
    Name:              "table",
    StyleName:         "TableStyleMedium2",
    ShowFirstColumn:   true,
    ShowLastColumn:    true,
    ShowRowStripes:    &disable,
    ShowColumnStripes: true,
})

注意，表格坐標區域至少需要包含兩列：字符型的標題列和內容列。每欄標題列的字符需保證是唯一的，並且必須在調用 AddTable 函式前設定表格的標題列資料。多個表格的坐標區域不能有交集。

可選參數 Name 用以設定自訂表格名稱，同一個工作表內的表格名稱應該是唯一的。

Excelize 支援的表格樣式 StyleName 參數：

TableStyleLight1 - TableStyleLight21
TableStyleMedium1 - TableStyleMedium28
TableStyleDark1 - TableStyleDark11

索引	索引	索引
	TableStyleLight1	TableStyleLight2
TableStyleLight3	TableStyleLight4	TableStyleLight5
TableStyleLight6	TableStyleLight7	TableStyleLight8
TableStyleLight9	TableStyleLight10	TableStyleLight11
TableStyleLight12	TableStyleLight13	TableStyleLight14
TableStyleLight15	TableStyleLight16	TableStyleLight17
TableStyleLight18	TableStyleLight19	TableStyleLight20
TableStyleLight21	TableStyleMedium1	TableStyleMedium2
TableStyleMedium3	TableStyleMedium4	TableStyleMedium5
TableStyleMedium6	TableStyleMedium7	TableStyleMedium8
TableStyleMedium9	TableStyleMedium10	TableStyleMedium11
TableStyleMedium12	TableStyleMedium13	TableStyleMedium14
TableStyleMedium15	TableStyleMedium16	TableStyleMedium17
TableStyleMedium18	TableStyleMedium19	TableStyleMedium20
TableStyleMedium21	TableStyleMedium22	TableStyleMedium23
TableStyleMedium24	TableStyleMedium25	TableStyleMedium26
TableStyleMedium27	TableStyleMedium28	TableStyleDark1
TableStyleDark2	TableStyleDark3	TableStyleDark4
TableStyleDark5	TableStyleDark6	TableStyleDark7
TableStyleDark8	TableStyleDark9	TableStyleDark10
TableStyleDark11

獲取表格

func (f *File) GetTables(sheet string) ([]Table, error)

根據給定的工作表名稱獲取指定工作表中的全部表格。

刪除表格

func (f *File) DeleteTable(name string) error

根據給定的表格名稱刪除表格。

自動過濾器

func (f *File) AutoFilter(sheet, rangeRef string, opts []AutoFilterOptions) error

根據給定的工作表名稱、儲存格坐標區域和條件式格式創建自動過濾器。电子表格中的自動過濾器可以對一些簡單的平面資料資料進列資料篩選。

例1，在名稱為 Sheet1 的工作表 A1:D4 區域創建自動過濾器：

err := f.AutoFilter("Sheet1", "A1:D4", []excelize.AutoFilterOptions{})

例2，在名稱為 Sheet1 的工作表 A1:D4 區域創建帶有格式條件的自動過濾器：

err := f.AutoFilter("Sheet1", "A1:D4", []excelize.AutoFilterOptions{
    {Column: "B", Expression: "x != blanks"},
})

參數 Column 指定了自動過濾器在過濾範圍內的基準欄。Excelize 暫不支援自動過濾器的計算，在設定過濾條件後，如果需要隱藏任何不符合過濾條件的列，可以使用 SetRowVisible() 設定列的可見度。

為欄設定過濾條件，參數 Expression 用於指定過濾條件運算，支援下列運算符：

==
!=
>
<
>=
<=
and
or

一個表達式可以包含一個或兩個由 and 和 or 運算符分隔的語句。例如：

x <  2000
x >  2000
x == 2000
x >  2000 and x <  5000
x == 2000 or  x == 5000

可以透過在表達式中使用空白或非空白值來實現空白或非空白資料的過濾：

x == Blanks
x == NonBlanks

Office Excel 還允許一些簡單的字符串匹配操作：

x == b*      // 以 b 開始
x != b*      // 不以 b 開始
x == *b      // 以 b 結尾
x != *b      // 不以 b 結尾
x == *b*     // 包含 b
x != *b*     // 不包含 b

我們還可以使用 * 來匹配任何字符或數字，用 ? 匹配任何單個字符或數字。除此之外，Office Excel 的自動過濾器不支援其他正則表達式的關鍵字。Excel 的正則表達式字符可以使用 ~ 進行轉義。

上述示例中的佔位符變數 x 可以被任何簡單的字符串替換。實際的佔位符名稱在內部被略過，所以以下所有表達式的效果都是等同的：

x     < 2000
col   < 2000
Price < 2000

清除儲存格緩存

func (f *File) UpdateLinkedValue() error

Excel 會在儲存時將儲存帶有公式的儲存格的計算結果，這會導致在 Office Excel 2007 和 2010 中文檔在開啓時，即便計算因子已經發生變化，公式的計算結果不會自動更新。參考鏈接：https://learn.microsoft.com/en-us/archive/msdn-technet-forums/e16bae1f-6a2c-4325-8013-e989a3479066。此函式會將活頁簿中所有緩存結果清除，這樣文檔在 Office Excel 中被重新開啓時會自動計算新的公式結果，但是由於計算後文檔發生了變化，在關閉文檔時 Office Excel 會提示是否儲存活頁簿。

清除儲存格緩存對活頁簿的影響表現為對 <v> 標籤的修改，例如，清除前的儲存格緩存：

<row r="19">
    <c r="B19">
        <f>SUM(Sheet2!D2,Sheet2!D11)</f>
        <v>100</v>
     </c>
</row>

清除儲存格緩存後：

<row r="19">
    <c r="B19">
        <f>SUM(Sheet2!D2,Sheet2!D11)</f>
    </c>
</row>

儲存格坐標切分

func SplitCellName(cell string) (string, int, error)

將工作表的儲存格坐標切分為欄名和列號。例如，將儲存格坐標 AK74 切分為 AK 和 74：

excelize.SplitCellName("AK74") // return "AK", 74, nil

儲存格坐標組合

func JoinCellName(col string, row int) (string, error)

將欄名和列號組合成工作表的儲存格坐標。

欄名轉索引

func ColumnNameToNumber(name string) (int, error)

將工作表的欄名（不區分大小寫）轉換為索引，對於錯誤的欄名格式將傳回錯誤。例如：

excelize.ColumnNameToNumber("AK") // returns 37, nil

索引轉欄名

func ColumnNumberToName(num int) (string, error)

將資料類別為整型的索引轉換為欄名。例如：

excelize.ColumnNumberToName(37) // returns "AK", nil

儲存格坐標轉索引

func CellNameToCoordinates(cell string) (int, int, error)

將由字母和數字組合而成的儲存格坐標轉換為 [X, Y] 形式的列、欄索引，或傳回錯誤。例如：

excelize.CellNameToCoordinates("A1") // returns 1, 1, nil
excelize.CellNameToCoordinates("Z3") // returns 26, 3, nil

索引轉儲存格坐標

func CoordinatesToCellName(col, row int, abs ...bool) (string, error)

將 [X, Y] 形式的列、欄索引轉換為由字母和數字組合而成的儲存格坐標，或傳回錯誤。例如：

excelize.CoordinatesToCellName(1, 1) // returns "A1", nil
excelize.CoordinatesToCellName(1, 1, true) // returns "$A$1", nil

創建條件式格式樣式

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

透過給定樣式為條件式格式創建樣式，樣式參數與 NewStyle 函式的相同。請注意，使用 RGB 色域色彩代碼時，目前僅支援設定字型、填滿、對齊和外框的色彩。

獲取條件式格式樣式

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

根據給定的條件式格式樣式索引獲取條件式格式樣式定義。

設定條件式格式

func (f *File) SetConditionalFormat(sheet, rangeRef string, opts []ConditionalFormatOptions) error

根據給定的工作表名稱、儲存格坐標區域和格式參數，為儲存格值創建條件式格式設定規則。條件式格式是 Office Excel 的一項功能，它允許您根據特定條件將格式應用於儲存格或一系列儲存格。

格式參數 Type 選項是必需的參數，它沒有默認值。允許的類別值及其相關參數是：

類別	參數
cell	Criteria
	Value
	MinValue
	MaxValue
time_period	Criteria
text	Criteria
text	Value
average	Criteria
duplicate	(none)
unique	(none)
top	Criteria
top	Value
bottom	Criteria
bottom	Value
blanks	(none)
no_blanks	(none)
errors	(none)
no_errors	(none)
2_color_scale	MinType
	MaxType
	MinValue
	MaxValue
	MinColor
	MaxColor
3_color_scale	MinType
	MidType
	MaxType
	MinValue
	MidValue
	MaxValue
	MinColor
	MidColor
	MaxColor
data_bar	MinType
	MaxType
	MinValue
	MaxValue
	BarBorderColor
	BarColor
	BarDirection
	BarOnly
	BarSolid
iconSet	IconStyle
	ReverseIcons
	IconsOnly
formula	Criteria

Criteria 參數用於設定儲存格資料的條件式格式運算符。它沒有默認值，同常與 excelize.ConditionalFormatOptions{Type: "cell"} 一起使用，支援的參數為：

文本描述字符	符號表示
between
not between
equal to	==
not equal to	!=
greater than	>
less than	<
greater than or equal to	>=
less than or equal to	<=

可以使用上面表格第一欄中的 Office Excel 文本描述字符，或者符號表示方法（between 與 not between 沒有符號表示法）作為條件式格式運算符。下面的相關部分顯示了其他條件式格式類別的特定標準。

Value：該值通常與 Criteria 參數一起使用，可以用確定的值作為設定儲存格條件式格式的條件參數：

err := f.SetConditionalFormat("Sheet1", "D1:D10",
    []excelize.ConditionalFormatOptions{
        {
            Type:     "cell",
            Criteria: ">",
            Format:   &format,
            Value:    "6",
        },
    },
)

Value 屬性也可以是儲存格引用：

err := f.SetConditionalFormat("Sheet1", "D1:D10",
    []excelize.ConditionalFormatOptions{
        {
            Type:     "cell",
            Criteria: ">",
            Format:   &format,
            Value:    "$C$1",
        },
    },
)

類別：Format - Format 參數用於指定滿足條件式格式標準時將應用於儲存格的格式。該參數可以透過 NewConditionalStyle() 方法來創建：

format, err := f.NewConditionalStyle(
    &excelize.Style{
        Font: &excelize.Font{Color: "9A0511"},
        Fill: excelize.Fill{
            Type: "pattern", Color: []string{"FEC7CE"}, Pattern: 1,
        },
    },
)
if err != nil {
    fmt.Println(err)
}
err = f.SetConditionalFormat("Sheet1", "D1:D10",
    []excelize.ConditionalFormatOptions{
        {Type: "cell", Criteria: ">", Format: &format, Value: "6"},
    },
)

注意：在 Office Excel 中，條件式格式疊加在現有儲存格格式上，並非所有儲存格格式屬性都可以修改。無法在條件式格式中修改的屬性包括：字型名稱、字型大小、上標和下標、對角外框、所有對齊屬性和所有保護屬性。

Office Excel 中內置了一些與條件式格式一起使用的默認樣式。可以使用以下 excelize 設定實現這些樣式效果：

// 淺紅填滿色深色文本代表較差
format1, err := f.NewConditionalStyle(
    &excelize.Style{
        Font: &excelize.Font{Color: "9A0511"},
        Fill: excelize.Fill{
            Type: "pattern", Color: []string{"FEC7CE"}, Pattern: 1,
        },
    },
)

// 黃填滿色深黃色文本代表一般
format2, err := f.NewConditionalStyle(
    &excelize.Style{
        Font: &excelize.Font{Color: "9B5713"},
        Fill: excelize.Fill{
            Type: "pattern", Color: []string{"FEEAA0"}, Pattern: 1,
        },
    },
)

// 綠填滿色深綠色文本代表較好
format3, err := f.NewConditionalStyle(
    &excelize.Style{
        Font: &excelize.Font{Color: "09600B"},
        Fill: excelize.Fill{
            Type: "pattern", Color: []string{"C7EECF"}, Pattern: 1,
        },
    },
)

類別：MinValue - 當條件式格式 Criteria 為 between 或 not between 時，MinValue 參數用於設定下限值。

// 高亮儲存格條件式格式規則： between...
err := f.SetConditionalFormat("Sheet1", "A1:A10",
    []excelize.ConditionalFormatOptions{
        {
            Type:     "cell",
            Criteria: "between",
            Format:   &format,
            MinValue: "6",
            MaxValue: "8",
        },
    },
)

類別：MaxValue - 當條件式格式 Criteria 為 between 或 not between 時，MaxValue 參數用於設定上限值，參考上面的例子。

類別：average - 平均類別用於指定 Office Excel 「前段後段規則」中「經典」樣式的「僅高於或低於平均值的數值設定格式」條件式格式：

// 前段後段規則：高於平均值...
err := f.SetConditionalFormat("Sheet1", "A1:A10",
    []excelize.ConditionalFormatOptions{
        {
            Type:         "average",
            Criteria:     "=",
            Format:       &format1,
            AboveAverage: true,
        },
    },
)

// 前段後段規則：低於平均值...
err := f.SetConditionalFormat("Sheet1", "B1:B10",
    []excelize.ConditionalFormatOptions{
        {
            Type:         "average",
            Criteria:     "=",
            Format:       &format2,
            AboveAverage: false,
        },
    },
)

類別：duplicate - 用於設定「醒目提示儲存格規則」中的「重復值 ...」：

// 醒目提示儲存格規則: 重復值...
err := f.SetConditionalFormat("Sheet1", "A1:A10",
    []excelize.ConditionalFormatOptions{
        {Type: "duplicate", Criteria: "=", Format: &format},
    },
)

類別：unique - 用於設定「醒目提示儲存格規則」中「只為以下內容的儲存格設定格式」的「特定文本」：

// 醒目提示儲存格規則，只為以下內容的儲存格設定格式: 特定文本 不等於...
err := f.SetConditionalFormat("Sheet1", "A1:A10",
    []excelize.ConditionalFormatOptions{
        {Type: "unique", Criteria: "=", Format: &format},
    },
)

類別：top - 用於設定「前段後段規則」中的「前 10 項...」或「前 10% ...」：

// 前段後段規則： 前 10 項...
err := f.SetConditionalFormat("Sheet1", "H1:H10",
    []excelize.ConditionalFormatOptions{
        {
            Type:     "top",
            Criteria: "=",
            Format:   &format,
            Value:    "6",
        },
    },
)

設定帶有百分比條件的條件式格式：

err := f.SetConditionalFormat("Sheet1", "A1:A10",
    []excelize.ConditionalFormatOptions{
        {
            Type:     "top",
            Criteria: "=",
            Format:   &format,
            Value:    "6",
            Percent:  true,
        },
    },
)

類別：2_color_scale - 用於設定帶有「雙色刻度」的「色階樣式」條件式格式：

// 色階：雙色刻度
err := f.SetConditionalFormat("Sheet1", "A1:A10",
    []excelize.ConditionalFormatOptions{
        {
            Type:     "2_color_scale",
            Criteria: "=",
            MinType:  "min",
            MaxType:  "max",
            MinColor: "#F8696B",
            MaxColor: "#63BE7B",
        },
    },
)

雙色刻度色階條件式格式可選參數：MinType、MaxType、MinValue、MaxValue、MinColor 和 MaxColor。

類別：3_color_scale - 用於設定帶有「三色刻度」的「色階樣式」條件式格式：

// 色階：三色刻度
err := f.SetConditionalFormat("Sheet1", "A1:A10",
    []excelize.ConditionalFormatOptions{
        {
            Type:     "3_color_scale",
            Criteria: "=",
            MinType:  "min",
            MidType:  "percentile",
            MaxType:  "max",
            MinColor: "#F8696B",
            MidColor: "#FFEB84",
            MaxColor: "#63BE7B",
        },
    },
)

三色刻度色階條件式格式可選參數： MinType、MidType、MaxType、MinValue、MidValue、MaxValue、MinColor、MidColor 和 MaxColor。

類別：data_bar - 用於設定「資料橫條」類別的條件式格式。

MinType - 參數 MinType 在條件式格式類別為 2_color_scale、3_color_scale 或 data_bar 時可用。參數 MidType 在條件式格式類別為 3_color_scale 時可用。例如：

// 資料橫條：漸層填滿
err := f.SetConditionalFormat("Sheet1", "K1:K10",
    []excelize.ConditionalFormatOptions{
        {
            Type:     "data_bar",
            Criteria: "=",
            MinType:  "min",
            MaxType:  "max",
            BarColor: "#638EC6",
        },
    },
)

參數 min/mid/max_types 可選值列表:

參數	類別
min	最低值（僅用於 `MinType`）
num	數字
percent	百分比
percentile	百分點值
formula	公式
max	最高值（僅用於 `MaxType`）

MidType - 當條件式格式類別為 3_color_scale 時使用，與 MinType 用法相同，參考上面的表格。

MaxType - 與 MinType 用法相同，參考上面的表格。

MinValue - 參數 MinValue 和 MaxValue 在條件式格式類別為 2_color_scale、3_color_scale 或 data_bar 時可用。參數 MidValue 在條件式格式類別為 3_color_scale 時可用。

MidValue - 在條件式格式類別為 3_color_scale 時可用，與 MinValue 的用法相同，參考上述文檔。

MaxValue - 與 MinValue 的用法相同，參考上述文檔。

MinColor - 參數 MinColor 和 MaxColor 在條件式格式類別為 2_color_scale、3_color_scale 或 data_bar 時可用。參數 MidColor 在條件式格式類別為 3_color_scale 時可用。例如：

// 色階：三色刻度
err := f.SetConditionalFormat("Sheet1", "B1:B10",
    []excelize.ConditionalFormatOptions{
        {
            Type:     "3_color_scale",
            Criteria: "=",
            MinType:  "min",
            MidType:  "percentile",
            MaxType:  "max",
            MinColor: "#F8696B",
            MidColor: "#FFEB84",
            MaxColor: "#63BE7B",
        },
    },
)

MidColor - 當條件式格式類別為 3_color_scale 時使用。與 MinColor 用法相同，參考上述文檔。

MaxColor - 與 MinColor 用法相同，參考上述文檔。

BarColor - 當條件式格式類別為 data_bar 時使用。與 MinColor 用法相同，參考上述文檔。

BarBorderColor - 用於設定資料橫條的外框線色彩，該設定僅在 Excel 2010 或更高版本中有效。

BarDirection - 用於設定資料橫條方向，可選值見下表:

可選值	說明
context	資料橫條方向根據電子錶格中數據上下文顯示
leftToRight	從右向左
rightToLeft	從左向右

BarOnly - 用於設定是否隱藏儲存格中的值，僅顯示資料橫條。

BarSolid - 用於設定資料橫條是否使用實心填滿（非漸層）填滿樣式，該設定僅在 Excel 2010 或更高版本中有效。

IconStyle - 用於設定圖示樣式，可選值見下表:

可選值
3Arrows
3ArrowsGray
3Flags
3Signs
3Stars
3Symbols
3Symbols2
3TrafficLights1
3TrafficLights2
3Triangles
4Arrows
4ArrowsGray
4Rating
4RedToBlack
4TrafficLights
5Arrows
5ArrowsGray
5Boxes
5Quarters
5Rating

ReverseIcons - 用於設定是否反轉圖示次序。

IconsOnly - 用於設定是否隱藏儲存格中的值，僅顯示圖示。

StopIfTrue - 用於設定是否「如果 True 則停止」，當一個條件式格式規則套用至一個或多個儲存格時，如果開啓此設定，一旦找到匹配規則的一個儲存格，將不會繼續尋找後續儲存格是否匹配。

例如，為名為 Sheet1 的工作表中，透過設定條件式格式高亮 A1:D4 區域儲存格中的最大值與最小值:

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    for r := 1; r <= 4; r++ {
        row := []int{
            rand.Intn(100), rand.Intn(100), rand.Intn(100), rand.Intn(100),
        }
        if err := f.SetSheetRow("Sheet1", fmt.Sprintf("A%d", r), &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    red, err := f.NewConditionalStyle(
        &excelize.Style{
            Font: &excelize.Font{
                Color: "9A0511",
            },
            Fill: excelize.Fill{
                Type:    "pattern",
                Color:   []string{"FEC7CE"},
                Pattern: 1,
            },
        },
    )
    if err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SetConditionalFormat("Sheet1", "A1:D4",
        []excelize.ConditionalFormatOptions{
            {
                Type:     "bottom",
                Criteria: "=",
                Value:    "1",
                Format:   &red,
            },
        },
    ); err != nil {
        fmt.Println(err)
        return
    }
    green, err := f.NewConditionalStyle(
        &excelize.Style{
            Font: &excelize.Font{
                Color: "09600B",
            },
            Fill: excelize.Fill{
                Type:    "pattern",
                Color:   []string{"C7EECF"},
                Pattern: 1,
            },
        },
    )
    if err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SetConditionalFormat("Sheet1", "A1:D4",
        []excelize.ConditionalFormatOptions{
            {
                Type:     "top",
                Criteria: "=",
                Value:    "1",
                Format:   &green,
            },
        },
    ); err != nil {
        fmt.Println(err)
        return
    }
    if err := f.SaveAs("Book1.xlsx"); err != nil {
        fmt.Println(err)
        return
    }
}

獲取條件式格式

func (f *File) GetConditionalFormats(sheet string) (map[string][]ConditionalFormatOptions, error)

根據給定的工作表名稱獲取該工作表中全部儲存格坐標區域和條件式格式參數。

刪除條件式格式

func (f *File) UnsetConditionalFormat(sheet, rangeRef string) error

根據給定的工作表名稱和儲存格坐標區域刪除條件式格式。

設定窗格

func (f *File) SetPanes(sheet string, panes *Panes) error

透過給定的工作表名稱和窗格樣式參數設定凍結窗格或拆分窗格。

ActivePane 定義了活動窗格，下表為該屬性的可選值：

列舉值	描述
bottomLeft (Bottom Left Pane)	當應用垂直和水平分割時，位於左下方的窗格。此值也適用於僅應用了水平分割的情況，將窗格分為上下兩個區域。在這種情況下，該值指定底部窗格。
bottomRight (Bottom Right Pane)	當垂直和水平時，位於底部右側的窗格。
topLeft (Top Left Pane)	當應用垂直和水平分割時，位於左上方的窗格。此值也適用於僅應用了水平分割的情況，將窗格分為上下兩個區域。在這種情況下，該值指定頂部窗格。此值也適用於僅應用垂直分割的情況，將窗格分割為右側和左側區域。在這種情況下，該值指定左側窗格。
topRight (Top Right Pane)	當應用垂直和水平分割時，位於右上方窗格。此值也適用於僅應用垂直分割的情況，將窗格分割為右側和左側區域。在這種情況下，該值指定右側窗格。

窗格狀態類別僅限於下表中當前列出的受支援的值：

列舉值	描述
frozen (Frozen)	窗格被凍結，但並不分裂。在此狀態下，當窗格被解除凍結然後再次解凍時，會生成單個窗格，而不會被分割。在這種狀態下，分割條不可調節。
split (Split)	窗格被分裂，但並不凍結。在此狀態下，用戶可以調整分割條。

XSplit - 水平分割點的位置。如果窗格凍結，則此值用於設定頂部窗格中可見的欄數。

YSplit - 垂直分割點的位置。如果窗格凍結，則此值用於設定左側窗格中可見的列數。該屬性的可能值由 W3C XML Schema double 資料類別定義。

TopLeftCell - 處於「從左到右」模式時,右下方窗格中左上角可見儲存格的位置。

SQRef - 參考儲存格坐標區域。可以是非連續的一組儲存格坐標區域。

例1，在名為 Sheet1 的工作表上凍結欄 A 並設定活動儲存格 Sheet1!K16：

err := f.SetPanes("Sheet1", &excelize.Panes{
    Freeze:      true,
    XSplit:      1,
    TopLeftCell: "B1",
    ActivePane:  "topRight",
    Selection: []excelize.Selection{
        {SQRef: "K16", ActiveCell: "K16", Pane: "topRight"},
    },
})

例2，在名為 Sheet1 的工作表上凍結第 1 到第 9 列，並設定活動儲存格區域 Sheet1!A11:XFD11：

err := f.SetPanes("Sheet1", &excelize.Panes{
    Freeze:      true,
    YSplit:      9,
    TopLeftCell: "A34",
    ActivePane:  "bottomLeft",
    Selection: []excelize.Selection{
        {SQRef: "A11:XFD11", ActiveCell: "A11", Pane: "bottomLeft"},
    },
})

例3，在名為 Sheet1 的工作表上創建拆分窗格，並設定活動儲存格 Sheet1!J60：

err := f.SetPanes("Sheet1", &excelize.Panes{
    Split:       true,
    XSplit:      3270,
    YSplit:      1800,
    TopLeftCell: "N57",
    ActivePane:  "bottomLeft",
    Selection: []excelize.Selection{
        {SQRef: "I36", ActiveCell: "I36"},
        {SQRef: "G33", ActiveCell: "G33", Pane: "topRight"},
        {SQRef: "J60", ActiveCell: "J60", Pane: "bottomLeft"},
        {SQRef: "O60", ActiveCell: "O60", Pane: "bottomRight"},
    },
})

例4，解凍並刪除名為 Sheet1 上的所有窗格：

err := f.SetPanes("Sheet1", &excelize.Panes{Freeze: false, Split: false})

獲取窗格

func (f *File) GetPanes(sheet string) (Panes, error)

透過給定的工作表名稱獲取帶有凍結窗格或拆分窗格的窗格格式。

色值計算

func (f *File) GetBaseColor(hexColor string, indexedColor int, themeColor *int) string

透過給定的十六進制色彩代碼、索引色彩和主題色彩傳回首選的十六進制色彩代碼。

func ThemeColor(baseColor string, tint float64) string

透過給定的十六進制色彩代碼與色調參數，計算出最終色彩。

電子錶格文檔中的文本有 3 種色彩：十六進制色彩、索引色彩和主題色彩。這些色彩的優先級為：十六進制色彩優先於主題色彩、主題色彩優先於索引色彩。另外，色彩還支援基於十六進制色彩應用色調值，因此可使用 ThemeColor 函式為首選色彩應用色調，以獲取計算出的實際十六進制色彩值。例如，獲取名為 Sheet1 的工作表 A1 儲存格的富文本中的文字色彩：

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f, err := excelize.OpenFile("Book1.xlsx")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    runs, err := f.GetCellRichText("Sheet1", "A1")
    if err != nil {
        fmt.Println(err)
        return
    }
    for _, run := range runs {
        var hexColor string
        if run.Font != nil {
            baseColor := f.GetBaseColor(run.Font.Color, run.Font.ColorIndexed, run.Font.ColorTheme)
            hexColor = strings.TrimPrefix(excelize.ThemeColor(baseColor, run.Font.ColorTint), "FF")
        }
        fmt.Printf("text: %s, color: %s\r\n", run.Text, hexColor)
    }
}

RGB與HSL色彩空間色值轉換

func RGBToHSL(r, g, b uint8) (h, s, l float64)

該函式提供方法將 RGB 色彩空間三元組轉換為 HSL 色彩空間三元組。

HSL與RGB色彩空間色值轉換

func HSLToRGB(h, s, l float64) (r, g, b uint8)

該函式提供方法將 HSL 色彩空間三元組轉換為 RGB 色彩空間三元組。

檔案 Writer

Write

func (f *File) Write(w io.Writer, opts ...Options) error

該函式提供方法將當前檔案內容寫入給定的 io.Writer。

WriteTo

func (f *File) WriteTo(w io.Writer, opts ...Options) (int64, error)

該函式透過實現 io.WriterTo 以儲存檔案。

WriteToBuffer

func (f *File) WriteToBuffer() (*bytes.Buffer, error)

該函式提供獲取當前檔案內容 *bytes.Buffer 的方法。

嵌入 VBA 專案

func (f *File) AddVBAProject(file []byte) error

該函式提供方法將包含函式和/或巨集的 vbaProject.bin 檔案嵌入到 Excel 檔案中，檔案擴展名應為 .xlsm 或者 .xltm。例如:

codeName := "Sheet1"
if err := f.SetSheetProps("Sheet1", &excelize.SheetPropsOptions{
    CodeName: &codeName,
}); err != nil {
    fmt.Println(err)
    return
}
file, err := os.ReadFile("vbaProject.bin")
if err != nil {
    fmt.Println(err)
    return
}
if err := f.AddVBAProject(file); err != nil {
    fmt.Println(err)
    return
}
if err := f.SaveAs("macros.xlsm"); err != nil {
    fmt.Println(err)
    return
}

Excel 日期時間轉換

func ExcelDateToTime(excelDate float64, use1904Format bool) (time.Time, error)

ExcelDateToTime 將 Excel 中以 float 類型表示的日期轉換為 time.Time 類型。

字符集轉碼器

func (f *File) CharsetTranscoder(fn func(charset string, input io.Reader) (rdr io.Reader, err error)) *File

CharsetTranscoder 為非 UTF-8 編碼的電子錶格文檔設定用戶提供指定自訂編碼轉換器支援。

設定 ZIP 寫入器

func (f *File) SetZipWriter(fn func(io.Writer) ZipWriter) *File

SetZipWriter 設定用於儲存活頁簿的用户自訂 ZIP 寫入函式。

工具函式

工具函式

創建表格

獲取表格

刪除表格

自動過濾器

清除儲存格緩存

儲存格坐標切分

儲存格坐標組合

欄名轉索引

索引轉欄名

儲存格坐標轉索引

索引轉儲存格坐標

創建條件式格式樣式

獲取條件式格式樣式

設定條件式格式

獲取條件式格式

刪除條件式格式

設定窗格

獲取窗格

色值計算

RGB與HSL色彩空間色值轉換

HSL與RGB色彩空間色值轉換

檔案 Writer

Write

WriteTo

WriteToBuffer

嵌入 VBA 專案

Excel 日期時間轉換

字符集轉碼器

設定 ZIP 寫入器

results matching ""

No results matching ""