# 页眉与页脚

为打印输出设置页眉、页脚文本。文本支持 libxlsxwriter 的格式控制码（如 `&L` 左对齐、`&C` 居中、`&R` 右对齐、`&P` 当前页码、`&N` 总页数、`&D` 当前日期、`&T` 当前时间、`&"Arial,Bold"` 指定字体、`&14` 指定字号等）。

## 函数原型

```php
setHeader(string $value, ?array $options = null): self
setFooter(string $value, ?array $options = null): self
```

### **string $value**

> 页眉 / 页脚文本，支持格式控制码。

### **array $options**

> 可选参数，键名如下：
>
> * `margin` —— 页眉 / 页脚到纸张边缘的距离（英寸），默认 `0.3`
> * `image_left` —— 左侧图片路径，配合文本中的 `&G` 占位符使用
> * `image_center` —— 居中图片路径
> * `image_right` —— 右侧图片路径

## 示例

```php
$config = [
    'path' => './tests'
];

$fileObject = new \Vtiful\Kernel\Excel($config);
$fileObject = $fileObject->fileName('tutorial.xlsx');

$filePath = $fileObject->header(['name', 'age'])
    ->data([
        ['viest', 21],
        ['wjx',   21]
    ])
    ->setHeader('&L&"Arial,Bold"&14销售报表&R&D')
    ->setFooter('&C第 &P 页 / 共 &N 页', ['margin' => 0.4])
    ->output();
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://xlswriter-docs.viest.me/zhong-wen-jian-ti/page-setup/header-footer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.