Skip to content

Commit

Permalink
Update zh version docs for the new AddHeaderFooterImage function
Browse files Browse the repository at this point in the history
- Add new exported HeaderFooterImagePositionType enumeration
- Add new fields PageOrder for PageLayoutOptions
  • Loading branch information
xuri committed Jan 10, 2025
1 parent 375431e commit 4bc9924
Show file tree
Hide file tree
Showing 4 changed files with 60 additions and 6 deletions.
1 change: 1 addition & 0 deletions zh-hans/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@
* [设置工作簿属性](workbook.md#SetWorkbookProps)
* [获取工作簿属性](workbook.md#GetWorkbookProps)
* [设置页眉和页脚](workbook.md#SetHeaderFooter)
* [添加页眉和页脚图片](workbook.md#AddHeaderFooterImage)
* [设置名称](workbook.md#SetDefinedName)
* [获取名称](workbook.md#GetDefinedName)
* [删除名称](workbook.md#DeleteDefinedName)
Expand Down
28 changes: 27 additions & 1 deletion zh-hans/workbook.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,22 @@ type Options struct {

`CultureInfo` 用以指定区域格式,该设置将在读取受到操作系统特定的区域日期和时间设置影响的数字格式时使用。

`HeaderFooterImagePositionType` 定义了页眉页脚图片位置类型。

```go
type HeaderFooterImagePositionType byte
```

下面是工作表页眉页脚位置枚举值。

```go
const (
HeaderFooterImagePositionLeft HeaderFooterImagePositionType = iota
HeaderFooterImagePositionCenter
HeaderFooterImagePositionRight
)
```

## 创建 {#NewFile}

```go
Expand Down Expand Up @@ -481,6 +497,8 @@ func (f *File) SetPageLayout(sheet string, opts *PageLayoutOptions) error

`BlackAndWhite` 属性用以指定单色打印,默认为关闭。

`PageOrder` 属性用以指定页面顺序,可选值为:`overThenDown`(先行后列)和 `downThenOver`(先列后行),默认值为 `downThenOver`

例如,将名为 `Sheet1` 的工作表页面布局设置为单色打印、起始页码为 `2`、横向、使用 A4(小) 210 × 297 毫米纸张并调整为 2 页宽、2 页高:

```go
Expand Down Expand Up @@ -639,7 +657,7 @@ FirstHeader | 首页页眉控制字符
</tr>
<tr>
<td><code>&amp;G</code></td>
<td>将指定对象做为背景(暂不支持)</td>
<td>将指定对象做为背景(使用 AddHeaderFooterImage 函数添加页眉页脚图片)</td>
</tr>
<tr>
<td><code>&amp;H</code></td>
Expand Down Expand Up @@ -725,6 +743,14 @@ err := f.SetHeaderFooter("Sheet1", &excelize.HeaderFooterOptions{
- 第一页中心部分的第一行上的文本为“Center Bold Header”, 第二行为日期
- 第一页上没有页脚

## 添加页眉页脚图片 {#AddHeaderFooterImage}

```go
func (f *File) AddHeaderFooterImage(sheet string, opts *HeaderFooterImageOptions) error
```

添加可通过 `&G` 控制字符在页眉和页脚定义中引用的图片,支持的图片文件格式为:EMF、EMZ、GIF、JPEG、JPG、PNG、SVG、TIF、TIFF、WMF 和 WMZ

## 设置名称 {#SetDefinedName}

```go
Expand Down
1 change: 1 addition & 0 deletions zh-tw/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@
* [設定活頁簿屬性](workbook.md#SetWorkbookProps)
* [獲取活頁簿屬性](workbook.md#GetWorkbookProps)
* [設定頁首和頁尾](workbook.md#SetHeaderFooter)
* [添加頁首和頁尾圖片](workbook.md#AddHeaderFooterImage)
* [設定名稱](workbook.md#SetDefinedName)
* [獲取名稱](workbook.md#GetDefinedName)
* [刪除名稱](workbook.md#DeleteDefinedName)
Expand Down
36 changes: 31 additions & 5 deletions zh-tw/workbook.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ type Options struct {

`UnzipSizeLimit` 用以指定開啓電子錶格檔案時的解壓縮大小限制(以位元組為單位),該值應大於或等於 `UnzipXMLSizeLimit`,默認大小限制為 16GB。

`UnzipXMLSizeLimit` 用以指定解壓每個工作表以及共享字符表時的內存限制(以位元組為單位),當大小超過此值時工作表 XML 文件將被解壓至系統臨時目錄,該值應小於或等於 `UnzipSizeLimit`,默認大小限制為 16MB。
`UnzipXMLSizeLimit` 用以指定解壓每個工作表以及共享字符表時的內存限制(以位元組為單位),當大小超過此值時工作表 XML 檔案將被解壓至系統臨時目錄,該值應小於或等於 `UnzipSizeLimit`,默認大小限制為 16MB。

`ShortDatePattern` 用以指定短日期數字格式代碼。在電子錶格應用程式中,可以透過為存儲格設定帶有日期格式的數字格式,將日期和時間序列號顯示為日期值。其中以星號 (\*) 開頭的日期格式響應為作業系統指定的區域日期和時間設定的更改。沒有星號的格式不受作業系統設定的影響。`ShortDatePattern` 用於指定讀取以星號開頭的日期格式時所應用的短日期數字格式代碼。

Expand All @@ -36,6 +36,22 @@ type Options struct {

`CultureInfo` 用以指定區域格式,該設定將在讀取受到作業系統特定的區域日期和時間設定影響的數字格式時使用。

`HeaderFooterImagePositionType` 定義了頁首和頁尾圖片位置類型。

```go
type HeaderFooterImagePositionType byte
```

下面是工作表頁首和頁尾位置枚舉值。

```go
const (
HeaderFooterImagePositionLeft HeaderFooterImagePositionType = iota
HeaderFooterImagePositionCenter
HeaderFooterImagePositionRight
)
```

## 新增 {#NewFile}

```go
Expand Down Expand Up @@ -207,13 +223,13 @@ func (f *File) UngroupSheets() error
func (f *File) SetSheetBackground(sheet, picture string) error
```

根據給定的工作表名稱和圖片文件路徑為指定的工作表設定平鋪效果的背景圖片。支援的圖片文件格式為:BMP、EMF、EMZ、GIF、JPEG、JPG、PNG、SVG、TIF、TIFF、WMF 和 WMZ
根據給定的工作表名稱和圖片檔案路徑為指定的工作表設定平鋪效果的背景圖片。支援的圖片檔案格式為:BMP、EMF、EMZ、GIF、JPEG、JPG、PNG、SVG、TIF、TIFF、WMF 和 WMZ

```go
func (f *File) SetSheetBackgroundFromBytes(sheet, extension string, picture []byte) error
```

根據給定的工作表名稱、圖片格式擴展名和圖片格式數據為指定的工作表設定平鋪效果的背景圖片。支援的圖片文件格式為:BMP、EMF、EMZ、GIF、JPEG、JPG、PNG、SVG、TIF、TIFF、WMF 和 WMZ
根據給定的工作表名稱、圖片格式擴展名和圖片格式數據為指定的工作表設定平鋪效果的背景圖片。支援的圖片檔案格式為:BMP、EMF、EMZ、GIF、JPEG、JPG、PNG、SVG、TIF、TIFF、WMF 和 WMZ

## 設定默認工作表 {#SetActiveSheet}

Expand Down Expand Up @@ -481,6 +497,8 @@ func (f *File) SetPageLayout(sheet string, opts *PageLayoutOptions) error

`BlackAndWhite` 屬性用以設定單色列印 `true``false`,默認值為 `false` 關閉。

`PageOrder` 屬性用以設定頁面順序,可選值為:`overThenDown`(循列欄印)和 `downThenOver`(循欄列印),默認值為 `downThenOver`

- 例如,將名為 `Sheet1` 的工作表頁面配置設定為單色列印、起始頁碼為 `2`、橫向、使用 A4(小) 210 × 297 毫米紙張並調整為 2 頁寬、2 頁高:

```go
Expand Down Expand Up @@ -639,7 +657,7 @@ FirstHeader | 首頁頁首控制字符
</tr>
<tr>
<td><code>&amp;G</code></td>
<td>將指定對象做為背景(暫不支援)</td>
<td>將指定對象做為背景(使用 AddHeaderFooterImage 函式添加頁首和頁尾圖片)</td>
</tr>
<tr>
<td><code>&amp;H</code></td>
Expand Down Expand Up @@ -725,6 +743,14 @@ err := f.SetHeaderFooter("Sheet1", &excelize.HeaderFooterOptions{
- 第一頁中心部分的第一行上的文本為「Center Bold Header」, 第二行為日期
- 第一頁上沒有頁尾

## 添加頁首和頁尾圖片 {#AddHeaderFooterImage}

```go
func (f *File) AddHeaderFooterImage(sheet string, opts *HeaderFooterImageOptions) error
```

添加可透過 `&G` 控制字符在頁首和頁尾定義中引用的圖片,支援的圖片檔案格式為:EMF、EMZ、GIF、JPEG、JPG、PNG、SVG、TIF、TIFF、WMF 和 WMZ

## 設定名稱 {#SetDefinedName}

```go
Expand Down Expand Up @@ -826,7 +852,7 @@ DocSecurity | 以數值表示的檔案安全級別。檔案安全定義為
Company | 與檔案關聯的公司的名稱
LinksUpToDate | 設定檔案中的超鏈接是否是最新的。設定為 `true` 表示超鏈接已更新,設定為 `false` 表示超鏈接已過時
HyperlinksChanged | 指定下一次開啓此檔案時是否應使用本部分中指定的新超鏈接更新超鏈接關係
AppVersion | 指定生成此檔案的應用程式的版本。值應為 XX.YYYY 格式,其中 XY 代表數值,否則文件將不符合標準
AppVersion | 指定生成此檔案的應用程式的版本。值應為 XX.YYYY 格式,其中 XY 代表數值,否則檔案將不符合標準

例如:

Expand Down

0 comments on commit 4bc9924

Please sign in to comment.