worksheet.views【ビュー】モジュール
メモ ( 概要 アクティブセル・セル選択 ビューの切替・ズーム倍率 ウィンドウ枠の分割 各種設定 ) 例
クラス: Pane【ビューペイン(区画)情報】 Selection【ビュー選択情報】 SheetView【シートビュー】 SheetViewList【シートビュー リスト】
メモ
概要
- Worksheet【ワークシート】のビューに関連するモジュール
- Excelの [表示]タブ - [ブックの表示]・[表示]・[ズーム]・[ウィンドウ] に対応
- Excelの [オプション] - [詳細設定] - [次のシートで作業するときの表示設定] に対応
- モジュール内定義
- 初期状態
- Worksheet【ワークシート】の views【シートビュー リスト】プロパティに SheetViewList【シートビュー リスト】が設定済
- 同一ワークシートを複数ウィンドウで表示しない場合、 sheet_view【シートビュー】プロパティでショートカット参照可
アクティブセル・セル選択
〔 例 〕- 注意事項
- ウィンドウ枠固定 ・ウィンドウ枠分割で分割状態だと不備がある為、以下は分割なしの場合
- アクティブセル
- Worksheet .sheet_view.selection[0]. activeCell【アクティブセル アドレス (単一セル)】にセルアドレスを設定
- 下記のセル選択も設定
- セル選択
- Worksheet .sheet_view.selection[0]. sqref【選択範囲シーケンス】に選択範囲を設定
- 選択範囲が複数の場合、Worksheet .sheet_view.selection[0]. activeCellId【アクティブセル インデックス】にインデックスを設定
ビューの切替・ズーム倍率
〔 例 〕- Worksheet【ワークシート】の sheet_view【シートビュー】を参照
- ビューの切替 (標準ビュー・ページレイアウトビュー・改ページプレビュー)
- ズーム倍率
ウィンドウ枠の分割
〔 例 〕- Worksheet【ワークシート】の sheet_view【シートビュー】を参照
- ウィンドウ枠分割用の Pane【ビューペイン(区画)情報】を生成
- pane【ビューペイン(区画)情報】プロパティに上記を上書き
各種設定
〔 例 〕Worksheet【ワークシート】の sheet_view【シートビュー】を参照
Excelの [オプション] - [詳細設定] - [次のシートで作業するときの表示設定]
項目 | プロパティ |
---|---|
行列番号を表示する | showRowColHeaders【見出し(行列番号部分)の表示有無】 |
計算結果の代わりに数式セルに表示する | showFormulas【数式の表示有無】 |
シートを右から左へ表示する | rightToLeft【右から左へ表示設定 (右端がA列)】 |
セロ値のセルにゼロを表示する | showZeros【ゼロ値の表示有無】 |
アウトラインが適用されている場合はアウトライン記号を表示する | showOutlineSymbols【アウトライン(グループ化)記号の表示有無】 |
枠線を表示する | showGridLines【枠線の表示有無】 (参照は、Worksheet . show_gridlines【枠線の表示有無】 でも可) |
枠線の色 | defaultGridColor【枠線のデフォルト色の使用有無】 colorId【枠線のカラーインデックス】 |
Excelの [表示]タブ - [表示]
項目 | プロパティ |
---|---|
ルーラー | showRuler【ルーラーの表示有無】 |
枠線 | showGridLines【枠線の表示有無】 |
見出し | showRowColHeaders【見出し(行列番号部分)の表示有無】 |
Excelの [表示]タブ - [ブックの表示] - [ページレイアウト]
項目 | プロパティ |
---|---|
余白の表示 / 余白を表示しない | showWhiteSpace【余白の表示有無 (ページレイアウト)】 |
外部リンク
- openpyxl (英語)
- ECMA-376:Office Open XML file formats (英語)
SpreadsheetML:- pane (View Pane)
- selection (Selection)
- sheetView (Worksheet View)
- sheetViews (Sheet Views)
Pane【ビューペイン(区画)情報】クラス
クラス定義
クラス | 備考 |
---|---|
親:openpyxl.descriptors.serialisable.Serialisable インポート:from openpyxl.worksheet.views import Pane | |
class Pane( xSplit=None, ySplit=None, topLeftCell=None, activePane="topLeft", state="split") | ビューペイン(区画)情報 xSplit (float)左右分割(固定)位置 ySplit (float)上下分割(固定)位置 topLeftCell左上表示セルアドレス (右下ペイン) activePaneアクティブペイン(区画) stateウィンドウ枠状態 |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
activePane | 'bottomLeft':左下 'bottomRight':右下 'topLeft':左上 'topRight':右上 | アクティブペイン(区画) |
state | 'frozen':ウィンドウ枠固定 'frozenSplit':ウィンドウ枠固定 (固定前はウィンドウ枠分割) 'split':ウィンドウ枠分割 | ウィンドウ枠状態 |
topLeftCell | str | 左上表示セルアドレス (右下ペイン) |
xSplit | None float | 左右分割(固定)位置 分割位置 (ウィンドウ枠分割:1/20 ポイント単位) 固定列数 (ウィンドウ枠の固定) |
ySplit | None float | 上下分割(固定)位置 分割位置 (ウィンドウ枠分割:1/20 ポイント単位) 固定行数 (ウィンドウ枠の固定) |
Selection【ビュー選択情報】クラス
クラス定義
クラス | 備考 |
---|---|
親:openpyxl.descriptors.serialisable.Serialisable インポート:from openpyxl.worksheet.views import Selection | |
class Selection( pane=None, activeCell="A1", activeCellId=None, sqref="A1") | ビュー選択情報 pane (str)ペイン(区画)位置 activeCell (str)アクティブセル アドレス (単一セル) activeCellId (int)アクティブセル インデックス sqref (str)選択範囲シーケンス |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
activeCell | str | アクティブセル アドレス (単一セル) |
activeCellId | int (0~) | アクティブセル インデックス (アクティブセルを含む選択範囲のインデックス) sqref【選択範囲シーケンス】が複数の場合に有効 |
pane | 'none' 'bottomLeft':左下 'bottomRight':右下 'topLeft':左上 'topRight':右上 | ペイン(区画)位置 |
sqref | str | 選択範囲シーケンス (範囲内にアクティブセルを含める) (複数:半角スペース区切り) |
SheetView【シートビュー】クラス
クラス定義
クラス | 備考 |
---|---|
親:openpyxl.descriptors.serialisable.Serialisable インポート:from openpyxl.worksheet.views import SheetView | |
class SheetView( windowProtection=None, showFormulas=None, showGridLines=None, showRowColHeaders=None, showZeros=None, rightToLeft=None, tabSelected=None, showRuler=None, showOutlineSymbols=None, defaultGridColor=None, showWhiteSpace=None, view=None, topLeftCell=None, colorId=None, zoomScale=None, zoomScaleNormal=None, zoomScaleSheetLayoutView=None, zoomScalePageLayoutView=None, zoomToFit=None, workbookViewId=0, selection=None, pane=None) | シートビュー windowProtection (bool)ウィンドウ保護の有無 showFormulas (bool)数式の表示有無 showGridLines (bool)枠線の表示有無 showRowColHeaders (bool)見出し(行列番号部分)の表示有無 showZeros (bool)ゼロ値の表示有無 rightToLeft (bool)右から左へ表示設定 (右端がA列) tabSelected (bool)タブの選択有無 showRuler (bool)ルーラーの表示有無 showOutlineSymbols (bool)アウトライン(グループ化)記号の表示有無 defaultGridColor (bool)枠線のデフォルト色の使用有無 showWhiteSpace (bool)余白の表示有無 (ページレイアウト) view (str)ビュータイプ topLeftCell (str)左上表示セルアドレス (右下ペイン) colorId (int)枠線のカラーインデックス zoomScale (int)ズーム倍率 (現在ビュー) zoomScaleNormal (int)ズーム倍率 (標準ビュー) zoomScaleSheetLayoutView (int)ズーム倍率 (改ページプレビュー) zoomScalePageLayoutView (int)ズーム倍率 (ページレイアウトビュー) zoomToFit (bool) workbookViewId (int)ブックビューId selection (list | tuple)ビュー選択情報リスト pane (Pane)ビューペイン(区画)情報 |
プロパティ
プロパティ | 型 | 備考 |
---|---|---|
colorId | int | 枠線のカラーインデックス |
defaultGridColor | bool | 枠線のデフォルト色の使用有無 |
pane | None:ウィンドウ枠の分割・固定 なし Pane | ビューペイン(区画)情報 |
rightToLeft | bool | 右から左へ表示設定 (右端がA列) |
selection | list[ Selection ] tuple( Selection ) | ビュー選択情報リスト |
showFormulas | bool | 数式の表示有無 |
showGridLines | bool | 枠線の表示有無 (Worksheet.show_gridlines ) |
showOutlineSymbols | bool | アウトライン(グループ化)記号の表示有無 |
showRowColHeaders | bool | 見出し(行列番号部分)の表示有無 |
showRuler | bool | ルーラーの表示有無 |
showWhiteSpace | bool | 余白の表示有無 (ページレイアウト) |
showZeros | bool | ゼロ値の表示有無 |
tabSelected | bool | タブの選択有無 |
tagname | str | タグ名 ('sheetView') |
topLeftCell | str | 左上表示セルアドレス (右下ペイン) |
view | None 'none' 'normal':標準ビュー 'pageBreakPreview':改ページプレビュー 'pageLayout':ページレイアウトビュー | ビュータイプ |
windowProtection | bool | ウィンドウ保護の有無 |
workbookViewId | int | ブックビューId |
zoomScale | None int (10 ~ 400:10% ~ 400%) | ズーム倍率 (現在ビュー) |
zoomScaleNormal | None:自動 int (0:自動 / 10 ~ 400:10% ~ 400%) | ズーム倍率 (標準ビュー) |
zoomScalePageLayoutView | None:自動 int (0:自動 / 10 ~ 400:10% ~ 400%) | ズーム倍率 (ページレイアウトビュー) |
zoomScaleSheetLayoutView | None:自動 int (0:自動 / 10 ~ 400:10% ~ 400%) | ズーム倍率 (改ページプレビュー) |
zoomToFit | bool | (チャートシートのみ) |
SheetViewList【シートビュー リスト】クラス
クラス定義
クラス | 備考 |
---|---|
親:openpyxl.descriptors.serialisable.Serialisable インポート:from openpyxl.worksheet.views import SheetViewList | |
class SheetViewList( sheetView=None, extLst=None) | シートビュー リスト sheetView (list | tuple)シートビュー リスト extLst (ExtensionList) ※ 初期状態で、Worksheet【ワークシート】 の views【シートビュー リスト】プロパティに生成済 先頭のシートビューは、 sheet_view【シートビュー】プロパティでショートカット参照 |