チュートリアル

簡単にライブラリーを使用するためのチュートリアルコレクション

チュートリアル»Python»Spire.XLS for Python»変換»Python で Excel を TXT に変換:区切り文字と文字コード
2026-11-20

Python で Excel のオートフィルターを追加・解除する方法

大量の明細から「特定の区分だけを見たい」「条件に合わない行を隠した状態で配布したい」——Excel のオートフィルターは、こうした場面で日常的に使われる機能です。定型の抽出作業であれば、フィルターの付与から条件の適用、解除までを Python で自動化しておくと、毎月の集計がそのまま繰り返せます。

Spire.XLS for Python では、オートフィルターの追加・条件設定・解除が Worksheet.AutoFilters を通して行えます。この記事では、フィルターを「付ける」「絞り込む」「解除する」の順に進めます。

クイックナビゲーション


1. オートフィルターの基本

オートフィルターは、見出し行にドロップダウン ボタンを付けて、列ごとに条件を指定して行を絞り込む仕組みです。Spire.XLS for Python では、次の 2 つのプロパティが操作の中心になります。

  • Worksheet.AutoFilters:シートのオートフィルターのコレクション
  • AutoFiltersCollection.Range:フィルターを付けるセル範囲

まずは、AutoFilters.Range に 見出し行 を指定して、フィルターを付けます。ここでは 12 行の出庫履歴(日付・品目・数量の 3 列)を使います。

日付 品目 数量
10月1日 食品 120
10月2日 飲料 80
… … …

2. フィルターを追加する

見出し行 A1:C1 にフィルターを付けると、3 列すべてに絞り込み用のドロップダウンが表示されます。

from spire.xls import *

# 出庫履歴のブックを読み込む
workbook = Workbook()
workbook.LoadFromFile("出庫履歴.xlsx")
sheet = workbook.Worksheets[0]

# 見出し行 A1:C1 にオートフィルターを付ける
sheet.AutoFilters.Range = sheet.Range["A1:C1"]

workbook.SaveToFile("フィルター追加.xlsx", ExcelVersion.Version2016)
workbook.Dispose()

見出し行にオートフィルターを追加した結果

指定した範囲の見出しに、絞り込み用のボタンが付きました。列をまたいで範囲を指定すると、それぞれの列にボタンが追加されます。


3. 条件で絞り込む

フィルターを付けたら、AutoFilters のメソッドで条件を指定します。条件の付け方は用途に応じて次のものが用意されています。

条件 メソッド
文字列で絞り込む AddFilter()
日付で絞り込む AddDateFilter()
空欄だけ表示する MatchBlanks()
空欄以外を表示する MatchNonBlanks()
背景色・文字色・アイコンで絞り込む AddFillColorFilter() / AddFontColorFilter() / AddIconFilter()
独自の条件式で絞り込む CustomFilter()

たとえば「品目が『その他』ではない行だけを表示する」場合は、FilterOperatorType.NotEqual を指定したカスタム フィルターを使います。

from spire.xls import *
from spire.xls.common import *

workbook = Workbook()
workbook.LoadFromFile("出庫履歴.xlsx")
sheet = workbook.Worksheets[0]

# 品目列(B 列)にオートフィルターを付ける
sheet.AutoFilters.Range = sheet.Range["B1:B13"]

# 絞り込みの対象となる列を取得する
filter_column = sheet.AutoFilters[0]

# 「その他」以外を表示する条件を設定する
sheet.AutoFilters.CustomFilter(filter_column, FilterOperatorType.NotEqual, String("その他"))

# 設定した条件で絞り込む
sheet.AutoFilters.Filter()

workbook.SaveToFile("カスタムフィルター.xlsx", ExcelVersion.Version2016)
workbook.Dispose()

カスタム フィルターで「その他」以外を表示した結果

カスタム フィルターは、比較演算子と文字列を組み合わせて指定します。Equal・NotEqual・GreaterThan・LessOrEqual などの演算子が使えます。CustomFilter() で条件を設定したあと、Filter() を呼び出すと実際に行が絞り込まれます。絞り込んだ状態でセルの値を一括で置き換えたい場合は、Python で Excel のデータを検索して置換する方法 と組み合わせられます。


4. フィルターを解除する

絞り込んだ状態のまま配布すると、受け取った側は全行がそろった表だと受け取ることもあります。配布用のファイルでは、フィルターを外してすべての行が表示された状態に戻しておきます。

AutoFilters.Clear() でオートフィルターを解除し、あわせて非表示になっていた行を表示状態に戻します。

from spire.xls import *

workbook = Workbook()
workbook.LoadFromFile("カスタムフィルター.xlsx")
sheet = workbook.Worksheets[0]

# オートフィルターを解除する
sheet.AutoFilters.Clear()

# 非表示になっていた行を表示状態に戻す
for row in range(1, sheet.LastRow + 1):
    sheet.ShowRow(row)

workbook.SaveToFile("フィルター解除.xlsx", ExcelVersion.Version2016)
workbook.Dispose()

オートフィルターを解除して全行を表示した結果

Clear() でドロップダウン ボタンが消え、ShowRow() ですべての行が表示された状態に戻りました。フィルターの解除と行の再表示をセットで行うのが、配布前に整えておきたい仕上げです。


まとめ

オートフィルターの操作は、AutoFilters.Range に範囲を指定して付与し、CustomFilter() などのメソッドで条件を設定して Filter() で適用します。解除するときは AutoFilters.Clear() を呼び、非表示行を ShowRow() で戻します。見出し行の指定ひとつで列ごとのドロップダウンが付くため、列の追加があっても範囲を広げるだけで対応できます。


FAQ

複数の列をまとめてフィルターの対象にできますか?

できます。AutoFilters.Range に A1:C13 のような表全体の範囲を指定すると各列が対象になり、条件は列ごとに設定します。

絞り込んだ状態のまま保存されますか?

保存されたファイルにはフィルターと絞り込み状態が保持されるため、開いた時点で条件が適用されています。配布用に整えたい場合は、解除の手順で全行を表示してから保存します。

条件を変えたい場合はどうすればよいですか?

いったん AutoFilters.Clear() で解除し、あらためて範囲と条件を設定し直します。同じブックに対してフィルターの付け直しを繰り返す場合も、毎回同じ手順で行えます。

フィルターはシートごとに設定できますか?

できます。Worksheet.AutoFilters はシート単位のコレクションなので、対象のシートを取得してから範囲を指定します。

実行に Microsoft Excel 本体は必要ですか?

必要ありません。フィルターの付与から絞り込み、解除まで、Python のライブラリ内で完結します。


ライセンスの案内

全機能を評価したい場合は、30 日間の無料ライセンスを申請 できます。申請したライセンスを適用すると、作成したドキュメントをそのまま利用できます。

Read 12 times