ブックの参照#

PythonからExcel#

xw.Book を使えば、最も簡単にブックに接続できます: xw.Book は接続先のブックを開いているかどうかを全てのExcelインスタンスに対して確認し、もし複数のExcelインスタンスが接続先のブックを同時に開いていればエラーを返します。アクティブなExcelインスタンスのブックに接続するには、 xw.books を使います（コメント部分は特定のインスタンスを参照する方法）:

>>> app = xw.App()  # or something like xw.apps[10559] for existing apps, get the available PIDs via xw.apps.keys()
>>> app.books['Book1']

注意: App はコンテキストマネージャーで使用するようにしてください。これにより、確実かつ適切にExcelインスタンスを閉じてクリーンアップできます。

with xw.App() as app:
    book = app.books['Book1']

	xw.Book	xw.books
新規ブック	`xw.Book()`	`xw.books.add()`
保存されていないブック	`xw.Book('Book1')`	`xw.books['Book1']`
（完全な）名前でブックを指定	`xw.Book(r'C:/path/to/file.xlsx')`	`xw.books.open(r'C:/path/to/file.xlsx')`

注釈

Windowsでファイルパスを指定するには、文字列の先頭に r を付加したraw文字列か、二重バックスラッシュを使用（ C:\\path\\to\\file.xlsx）するようにしてください。

ExcelからPython (RunPython)#

To reference the calling book when using RunPython in VBA, use xw.Book.caller(), see "RunPython" でPythonを呼び出す. Check out the section about デバッグ to see how you can call a script from both sides, Python and Excel, without the need to constantly change between xw.Book.caller() and one of the methods explained above.

ユーザー定義関数（User Defined Functions, UDFs）#

RunPython とは異なり、UDFの場合は xw.Book.caller() は必要ではありません。詳細はユーザー定義関数 (UDFs) をご覧ください。通常は、UDFを呼び出しているrangeオブジェクトを表す引数 caller を使用することになるでしょう。