Go Excelize API源碼閱讀GetPageLayout及SetPageMargins
一、Go-Excelize簡介
Excelize 是 Go 語言編寫的用于操作 Office Excel 文檔基礎(chǔ)庫，基于 ECMA-376，ISO/IEC 29500 國際標(biāo)準(zhǔn)。
- 可以使用它來讀取、寫入由 Microsoft Excel™ 2007 及以上版本創(chuàng)建的電子表格文檔。
- 支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多種文檔格式，高度兼容帶有樣式、圖片(表)、透視表、切片器等復(fù)雜組件的文檔，并提供流式讀寫 API，用于處理包含大規(guī)模數(shù)據(jù)的工作簿。
- 可應(yīng)用于各類報表平臺、云計算、邊緣計算等系統(tǒng)。
使用本類庫要求使用的 Go 語言為 1.15 或更高版本。
二、 GetPageLayout
func (f *File) GetPageLayout(sheet string, opts ...PageLayoutOptionPtr) error
根據(jù)給定的工作表名稱和頁面布局參數(shù)獲取工作表的頁面布局屬性。
- 通過 PageLayoutOrientation 方法獲取頁面布局方向
- 通過 PageLayoutPaperSize 方法獲取頁面紙張大小 例如，獲取名為 Sheet1 的工作表頁面布局設(shè)置：
f := excelize.NewFile()
const sheet = "Sheet1"
var (
orientation excelize.PageLayoutOrientation
paperSize excelize.PageLayoutPaperSize
)
if err := f.GetPageLayout("Sheet1", &orientation); err != nil {
fmt.Println(err)
}
if err := f.GetPageLayout("Sheet1", &paperSize); err != nil {
fmt.Println(err)
}
fmt.Println("Defaults:")
fmt.Printf("- orientation: %q\n", orientation)
fmt.Printf("- paper size: %d\n", paperSize)
輸出結(jié)果如下：
Defaults:
- orientation: "portrait"
- paper size: 1
廢話少說，我們來看一看源碼：
// GetPageLayout provides a function to gets worksheet page layout.
//
// Available options:
// PageLayoutOrientation(string)
// PageLayoutPaperSize(int)
// FitToHeight(int)
// FitToWidth(int)
func (f *File) GetPageLayout(sheet string, opts ...PageLayoutOptionPtr) error {
s, err := f.workSheetReader(sheet)
if err != nil {
return err
}
ps := s.PageSetUp
for _, opt := range opts {
opt.getPageLayout(ps)
}
return err
}
選項參數(shù)有4個，分別是PageLayoutOrientation(string)、PageLayoutPaperSize(int)、FitToHeight(int)、FitToWidth(int)。 源碼邏輯很簡單，讀取工作表，然后獲取工作表的PageSetUp字段，它是*xlsxPageSetUp類型的。
下圖是xlsxPageSetUp類型的具體情況?？梢钥吹剿哂羞@么多結(jié)構(gòu)體成員變量。
然后是遍歷不定長變量opts，對于每個參數(shù)執(zhí)行對應(yīng)的操作。
....
如此，對每個參數(shù)都執(zhí)行相應(yīng)的方法之后，我們就將獲取到的值存在了參數(shù)之中，因為從頭到尾都是對參數(shù)的指針進(jìn)行操作。
三、SetPageMargins
func (f *File) SetPageMargins(sheet string, opts ...PageMarginsOptions) error
根據(jù)給定的工作表名稱和頁邊距參數(shù)設(shè)置工作表的頁邊距。頁邊距可選參數(shù)：
| 參數(shù) | 數(shù)據(jù)類型 |
|---|---|
| PageMarginBotom | float64 |
| PageMarginFooter | float64 |
| PageMarginHeader | float64 |
| PageMarginLeft | float64 |
| PageMarginRight | float64 |
| PageMarginTop | float64 |
例如，設(shè)置名為 Sheet1 的工作表頁邊距:
f := excelize.NewFile()
const sheet = "Sheet1"
if err := f.SetPageMargins(sheet,
excelize.PageMarginBottom(1.0),
excelize.PageMarginFooter(1.0),
excelize.PageMarginHeader(1.0),
excelize.PageMarginLeft(1.0),
excelize.PageMarginRight(1.0),
excelize.PageMarginTop(1.0),
); err != nil {
fmt.Println(err)
}
該API源碼如下：
// SetPageMargins provides a function to set worksheet page margins.
//
// Available options:
// PageMarginBottom(float64)
// PageMarginFooter(float64)
// PageMarginHeader(float64)
// PageMarginLeft(float64)
// PageMarginRight(float64)
// PageMarginTop(float64)
func (f *File) SetPageMargins(sheet string, opts ...PageMarginsOptions) error {
s, err := f.workSheetReader(sheet)
if err != nil {
return err
}
pm := s.PageMargins
if pm == nil {
pm = new(xlsxPageMargins)
s.PageMargins = pm
}
for _, opt := range opts {
opt.setPageMargins(pm)
}
return err
}
先讀取工作表，然后獲取PageMargins字段。
如果這個字段為空，就新建一個xlsxPageMargins對象，給s.PageMargins。
for _, opt := range opts {
opt.setPageMargins(pm)
}
然后對根據(jù)opt的類型，對pm指針進(jìn)行操作。
等等...
一如既往的這些操作...
以上就是Go Excelize API源碼閱讀GetPageLayout及SetPageMargins的詳細(xì)內(nèi)容，更多關(guān)于Go Excelize API源碼閱讀的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
go語言在請求http時加入自定義http header的方法
這篇文章主要介紹了go語言在請求http時加入自定義http header的方法,實例分析了Go語言http請求的原理與操作技巧,需要的朋友可以參考下2015-03-03
這篇文章主要為大家介紹了go語言的變量定義示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2022-12-12
這篇文章主要介紹了使用騰訊云go sdk 查詢對象存儲中最新文件,這包括如何創(chuàng)建COS客戶端,如何逐頁檢索對象列表,并如何對結(jié)果排序以找到最后更新的對象,我們還展示了如何優(yōu)化用戶體驗,通過實時進(jìn)度更新和檢索多個文件來改進(jìn)程序,需要的朋友可以參考下2024-03-03
本文詳細(xì)講解了Go語言之嵌入類型，文中通過示例代碼介紹的非常詳細(xì)。對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-07-07
在本教程中，我們將學(xué)習(xí)如何在 Golang 中執(zhí)行shell命令（如 ls、mkdir 或 grep ），我們還將學(xué)習(xí)如何通過 stdin 和 stdout 傳遞 I/O 到正在運(yùn)行的命令，以及管理長時間運(yùn)行的命令，感興趣的同學(xué)可以借鑒一下2023-05-05
這篇文章主要介紹了詳解Golang使用MongoDB通用操作,本文給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2020-12-12
Go內(nèi)存分配之結(jié)構(gòu)體優(yōu)化技巧
這篇文章主要為大家詳細(xì)介紹了Go語言內(nèi)存分配之結(jié)構(gòu)體優(yōu)化技巧的相關(guān)知識,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2023-11-11
本文將介紹Go語言中的值賦值和引用賦值,并比較它們之間的差異,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2023-10-10
Golang中如何使用lua進(jìn)行擴(kuò)展詳解
這篇文章主要給大家介紹了關(guān)于Golang中如何使用lua進(jìn)行擴(kuò)展的相關(guān)資料，這是最近在工作中遇到的一個問題，覺著有必要分享出來給大家學(xué)習(xí)，文中給出了詳細(xì)的示例，需要的朋友可以參考借鑒，下面來一起看看吧。2017-10-10
go mod 安裝依賴 unkown revision問題的解決方案
這篇文章主要介紹了go mod 安裝依賴 unkown revision問題的解決方案，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2021-05-05