ヘッダーとフッターは、ドキュメントの各ページの上部および下部に配置される領域で、追加情報や要素を表示するために使用されます。ヘッダーには主にドキュメントのタイトル、会社名、日付などが含まれ、フッターにはページ番号、ファイルパス、著作権表示などが記載されることが一般的です。Excel にヘッダーとフッターを設定することで、ドキュメントの見栄えがよりプロフェッショナルで整理されたものになります。
この記事では、Spire.XLS for Python を使用して Excel にヘッダーおよびフッターを追加する方法をご紹介します。
Spire.XLS for Python は、Excel のページ設定(ヘッダー・フッター含む)を扱うために PageSetup クラスを提供しています。具体的には、LeftHeader、CenterHeader、RightHeader、LeftFooter などのプロパティがあり、ヘッダーやフッターの左・中央・右の各セクションを操作できます。ヘッダーやフッターにフィールドを追加したり、テキストに書式を適用したりするには、以下のスクリプトを使用します。
スクリプト | 説明 |
---|---|
&P | 現在のページ番号 |
&N | 総ページ数 |
&D | 現在の日付 |
&T | 現在の時刻 |
&G | 画像を表示 |
&A | ワークシート名 |
&F | ファイル名 |
&B | 太字テキスト |
&I | イタリック体テキスト |
&U | 下線付きテキスト |
&"フォント名" | フォントの指定(例:&"Arial") |
& 数値 | フォントサイズの指定(例:&12) |
&Kカラーコード | フォントカラーの指定(例:&KFF0000) |
Spire.XLS for Python のインストール
この操作には、Spire.XLS for Python と plum-dispatch v1.7.4 が必要です。これらは、Spire.XLS for Python の公式ウェブサイトから手動でダウンロードするか、以下の pip コマンドでインストールできます。
pip install Spire.XLS
Excel にテキストのヘッダーまたはフッターを追加する方法
Spire.XLS for Python を使えば、ヘッダーまたはフッターの各セクションに書式付きテキストを追加できます。ファイル名やページ番号、日付など、さまざまな情報を柔軟に設定できます。以下はその手順です。
- Workbook クラスのオブジェクトを作成します。
- Workbook.LoadFromFile() メソッドでサンプルの Excel ファイルを読み込みます。
- Workbook.Worksheets[index] プロパティを使用して対象のワークシートを取得します。
- PageSetup.LeftHeader プロパティを使って、左側のヘッダーに任意のテキストを設定します。
- PageSetup.CenterFooter プロパティに &P を設定して中央フッターにページ番号を追加します。
- PageSetup.RightFooter プロパティに &D を設定して右フッターに日付を追加します。
- Workbook.SaveToFile() メソッドで結果のファイルを保存します。
from spire.xls import Workbook, ViewMode
inputFile = "Sample.xlsx"
outputFile = "output/テキストのヘッダーとフッター.xlsx"
# Workbook クラスのオブジェクトを作成します
workbook = Workbook()
# サンプルファイルをディスクから読み込みます
workbook.LoadFromFile(inputFile)
# このファイルの最初のワークシートを取得します
Worksheet = workbook.Worksheets
# 左ヘッダーにテキストを追加します
Worksheet.PageSetup.LeftHeader = "&\"Yu Gothic UI\"&14 注文記録"
# 中央フッターにページ番号を追加します
Worksheet.PageSetup.CenterFooter = "&P"
# 右フッターに現在の日付を追加します
Worksheet.PageSetup.RightFooter = "&D"
# シートの表示モードを設定します
Worksheet.ViewMode = ViewMode.Layout
# 結果ファイルを保存します
workbook.SaveToFile(outputFile)
workbook.Dispose()
Excel に画像のヘッダーまたはフッターを追加する方法
さらに、Spire.XLS for Python はヘッダーやフッターに画像を追加することも可能です。以下はその詳細な手順です。
- Workbook クラスのオブジェクトを作成します。
- Workbook.LoadFromFile() メソッドで Excel ファイルを読み込みます。
- Workbook.Worksheets[index] プロパティで対象のワークシートを取得します。
- PageSetup.LeftHeaderImage プロパティで画像を読み込み、左ヘッダーの画像として設定します。
- PageSetup.LeftHeader に "&G" を設定して画像を表示させます。
- PageSetup.CenterFooterImage プロパティで画像を読み込み、中央フッターの画像として設定します。
- PageSetup.CenterFooter に "&G" を設定して画像を表示させます。
- Workbook.SaveToFile() メソッドでファイルを保存します。
from spire.xls import Workbook, Stream, ViewMode
inputFile = "Sample.xlsx"
inputImage = "Logo.png"
outputFile = "output/画像付きヘッダーとフッター.xlsx"
# Workbook クラスのオブジェクトを作成します
workbook = Workbook()
# サンプルファイルをディスクから読み込みます
workbook.LoadFromFile(inputFile)
# このファイルの最初のシートを取得します
sheet = workbook.Worksheets.get_Item(0)
# 画像ファイルをディスクから読み込みます
imageStream = Stream(inputImage)
# 左ヘッダーに画像を追加します
sheet.PageSetup.LeftHeaderImage = imageStream
sheet.PageSetup.LeftHeader = "&G"
# 中央フッターに画像を追加します
sheet.PageSetup.CenterFooterImage = imageStream
sheet.PageSetup.CenterFooter = "&G"
# シートの表示モードを設定します
sheet.ViewMode = ViewMode.Layout
# 結果ファイルを保存します
workbook.SaveToFile(outputFile)
workbook.Dispose()
一時ライセンスを申請する
結果ドキュメントから評価メッセージを削除したい場合、または機能制限を取り除く場合は、についてこのメールアドレスはスパムボットから保護されています。閲覧するにはJavaScriptを有効にする必要があります。にお問い合わせ、30 日間有効な一時ライセンスを取得してください。