📽️ 🌎 🚶🏽 Pythonプログラムでドキュメントをプレビューする 🍵 💷 🤟🏻

私が関与しているシステムの1つでは、docファイルがデータベースに追加されます。

これらのファイルの表示をデータベースで動作する私のプログラムに添付することが可能かどうか疑問に思っていました。

何らかの理由で、このような問題の自然な解決策は、通常、コマンドラインでファイル名を指定してMSWordを起動することです。しかし、この方法は、控えめに言っても、あまり安全ではありません。ドキュメントにマクロがあるか、ドキュメントではなく、クラッカーによって特別に準備されたファイルである可能性があります。したがって、Officeに実装されている特別な表示オブジェクトを使用することをお勧めします。ドキュメントを表示する以外に何もできないため、より安全です。

また、1つのドキュメント形式に限定しない場合、ボーナスとして、Windowsで標準のビューアが登録されている他の形式の添付ドキュメントを表示できます。

今後は-PyWin32を使用してすべてが判明しました。確かに、このプロセスで予期しないCOMインターフェイスをサポートするためにパッケージをコンパイルする必要がありましたが、犠牲者はいませんでした。

だから私たちは何を知っていますか

MSDNによると、システムには標準のIPreviewHandlerインターフェイスを実装するビューアーがあり、インターフェイスはShobjidl.hインクルーダーで説明されています
特定のファイル拡張子についてシステムに登録されたビューアがあるかどうかを確認できます-ブランチがある場合はHKEY_CLASSES_ROOT \ <extn> \ Shellex \ {8895b1c6-b41f-4c1c-a562-0d564250836f} （「 <extn> 」はドット付きのファイル拡張子、つまり、「. doc 」、「. pdf 」など）、デフォルト値があり、この値は対応するコンポーネントのCLSIDです。
登録されているすべてのビューアは、レジストリブランチHKEY_LOCAL_MACHINE \ SOFTWARE \ Microsoft \ Windows \ CurrentVersion \ PreviewHandlersにリストされています。

作業指示書：

4.ディスク上にドキュメントがあります。

5.ファイル拡張子からCLSIDを見つけ、それを使用してビューアーオブジェクトを作成します。

6.名前またはIStreamストリームのいずれかで、ファイルを使用してオブジェクトを初期化します。これについては後で詳しく説明します。

7. SetWindowメソッドを呼び出して、オブジェクトに表示するウィンドウをオブジェクトに示します。ここではウィンドウハンドルが必要ですが、問題はありません。Qtウィジェットには、このためのwinId（）メソッドがあります。

8.表示を開始するには、オブジェクトでDoPrevewメソッドを呼び出します。

9.ウィンドウのサイズを変更する場合は、SetRectを呼び出して、それに応じてビューのサイズを変更する必要があります。

10.ビューアが不要になったとき-アンロードと呼びます

CLSIDを使用してコンポーネントを作成するには、PythonがPythonでどれほど簡単かを調べる必要があります（ Pythonプログラムがあるとはまだ言いませんか？）。

Stack Overflowでは、そのようなことのためにPyWin32をインストールすることをお勧めします。では、試してみましょう。

C:\>pip3 install pywin32 Collecting pywin32 Could not find a version that satisfies the requirement pywin32 (from versions: ) No matching distribution found for pywin32

なに...？「バージョンが見つからない」という意味では？

再びグーグル-はい、「pypiwin32」をインストールする必要があります。

Pypiwin32は、健全なパッケージツール（つまり、

ホイール）。 TwistedプロジェクトのBDFLによって再パッケージ化されました。使用する場合

pip、またはvirtualenvs（そして、もしあなたが

開始しない）、pypiwin32を使用します。

 C:\>pip3 install pypiwin32

配信済み。お疲れ様でした！

確認する必要があります。小さなスクリプトを書いています。

 #!/usr/bin/python3 # -*- coding: utf-8 -*- import pythoncom import pywintypes adobe = pywintypes.IID('{DC6EFB56-9CFA-464D-8880-44885D7DC193}') CLSID_IPreviewHandler = '{8895B1C6-B41F-4C1C-A562-0D564250836F}' iid = pywintypes.IID(CLSID_IPreviewHandler) handler = pythoncom.CoCreateInstance( adobe, None, pythoncom.CLSCTX_LOCAL_SERVER, iid) print(handler)

ここでは、システムで使用できるビューアの1つ、特にAdobe pdfを作成します。それ以上のアクションなしで、単純に作成されます。動作する場合は、そのメソッドをプルできます。

立ち上げて、とても驚きました

 Traceback (most recent call last): File "C:\Projects\pytest\w1.py", line 19, in <module> iid) TypeError: There is no interface object registered that supports this IID

つまり、彼はビューアを作成しましたが、それを返すことができませんでした-いいえ、彼はent IIDをサポートする登録済みインターフェースオブジェクトを持っています。

いくつかの点で、私は彼に同意します-Pythonは、作成されたCOMオブジェクトにメソッドがあることを知って、Pythonスクリプトから呼び出せるようにする必要があります。この情報はIDispatchインターフェースによって提供されますが、このオブジェクトにはありません...

それではどうしますか？エラーメッセージのテキストをグーグルで検索すると、 Mark Hammond パッケージの開発者の答えが見つかります。

>ドキュメントPythonCOM.htmlは、これが「pyd」モジュールを使用して行われると述べています

>がインポートされます。 これは、アクセスされるすべてのインターフェースに対して

>この方法では、CまたはC ++モジュールをそのために特別に作成する必要があります

>インターフェース？

まさに。ただし、多くの便利なオブジェクトが「IDispatch」を使用することに注意してください

インターフェイス、しかし、いけないカスタムオブジェクトの場合、これは本当です。

>これが必要な場合、例を見ることができる場所はありますか

>そのモジュールのコードの？ そうでない場合は、どのようにPythonに伝えるのですか？

> IIDに関連付けられたインターフェイスオブジェクト？

win32comのソースには多くの例があります。最も

最近のセットは「internet」および「axcontrols」ディレクトリにあります。

また、Cコードを生成するための2つのオプションがあることに注意してください。一

win32comに付属している「makegw」を使用することです-.hファイルを取ります

それ自体がIDLファイルから生成され、Cソースを作成している

コード。しかし、それほど柔軟ではありません。 SWIGもあります。

より柔軟ですが、おそらく設定するためのはるかに高い学習曲線。

インターフェイスが小さく、IDLから生成された.Hファイルにある場合、

次に、「makegw」と私が言及したサンプル（これは

makepyで生成された場所自体）

要するに、古き良きC.インクルーダー、コンパイラ、リンカで飛ぶことを申し出ます-それだけで、Pythonに残して、避けたいと思いました。そして、ソースパッケージから例を取ります。私はソースをダウンロードしてから、便利になりました。

そして2つの組み立てオプション

パッケージに含まれる「Makegw」
より涼しいSWIG

SWIGについては、ハブ " Python、Modules、SWIG、Windows " mclanderに関する記事がありました。そこでは、すべてが素晴らしく、簡単で、クールだと思われます。私はこのSWIGをダウンロードし、それを理解しようとしました-すぐに解決しませんでしたが、makegwで判明しました。

makegwは、必要なパラメーター（この場合はWindows SDKからのShObjIdl.hへのパス、および必要なインターフェイス）を使用して実行する必要がある実質的に1つの関数を持つモジュールです。そこで、スクリプトを作成しました。

mk.py

 import win32com.makegw.makegw inc = "C:/Program Files (x86)/Windows Kits/10/Include/10.0.14393.0/um/" h = inc + "ShObjIdl.h" win32com.makegw.makegw.make_framework_support(h, "IPreviewHandler")

スクリプトは機能し、2つのファイルPyIPreviewHandler.cppとPyIPreviewHandler.hが判明しました。オープナーを覗いてみると、この写真が見えます。

 // *** The input argument hwnd of type "__RPC__in HWND" was not processed *** // Please check the conversion function is appropriate and exists! __RPC__in HWND hwnd; PyObject *obhwnd; // @pyparm <o Py__RPC__in HWND>|hwnd||Description for hwnd

 // *** The input argument prc of type "__RPC__in const RECT *" was not processed *** // Please check the conversion function is appropriate and exists! __RPC__in const RECT prc; PyObject *obprc; // @pyparm <o Py__RPC__in const RECT>|prc||Description for prc

つまり、makegwは、「__ RPC__in HWND」、「__ RPC__in const RECT *」などの意味が何であるかを理解できず、理解しようとしませんでした。私が警告したこと。

コンパイルしようとしても愚かだったので、私も自分の手を支配したくなかったので、問題を回避しようとしました-これらの構造を単音節の同等物に置き換えてください。

ShObjIdl.hを取得し、IPreviewHandlerインターフェイスの説明をそこから別のファイルに取り出し、パラメーターのタイプを変更しました。

preview.h

 #include "rpc.h" #include "rpcndr.h" #include "windows.h" #include "ole2.h" //#define __RPC__in #ifndef __IPreviewHandler_INTERFACE_DEFINED__ #define __IPreviewHandler_INTERFACE_DEFINED__ /* interface IPreviewHandler */ /* [uuid][object] */ #include "prtypes.h" EXTERN_C const IID IID_IPreviewHandler; MIDL_INTERFACE("8895b1c6-b41f-4c1c-a562-0d564250836f") IPreviewHandler : public IUnknown { public: virtual HRESULT STDMETHODCALLTYPE SetWindow( /* [in] */ HWND hwnd, /* [in] */ CRECTPTR prc) = 0; virtual HRESULT STDMETHODCALLTYPE SetRect( /* [in] */ CRECTPTR prc) = 0; virtual HRESULT STDMETHODCALLTYPE DoPreview( void) = 0; virtual HRESULT STDMETHODCALLTYPE Unload( void) = 0; virtual HRESULT STDMETHODCALLTYPE SetFocus( void) = 0; virtual HRESULT STDMETHODCALLTYPE QueryFocus( /* [out] */ HWNDPTR phwnd) = 0; virtual HRESULT STDMETHODCALLTYPE TranslateAccelerator( /* [in] */ MSGPTR pmsg) = 0; }; #endif

別のファイルに記述された新しいタイプ

prtypes.h

 typedef const RECT *CRECTPTR; typedef const MSG *CMSGPTR; typedef MSG *MSGPTR; typedef HWND *HWNDPTR;

したがって、スクリプトでは、インクルーダーの名前を変更しました。同時に、ゲートウェイオブジェクトの生成をオフにしました。実際には、実装されたインターフェイスを外部ライブラリから取得し、Pythonで作成しないため、生成に関与するゲートウェイは必要ありません。

mk.py

 import win32com.makegw.makegw win32com.makegw.makegw.make_framework_support("preview.h", "IPreviewHandler", bMakeGateway = 0)

立ち上げました

 C:\Projects\pytest>python mk.py IPreviewHandler

そのため、パッケージを収集する必要があります。 Pythonでドキュメントをスモークした後、アセンブリ（こことここ）でsetup.pyスクリプトを作成することが必要で十分であることがわかりました。おそらく既にご存知でしょうが、パッケージを作成するという意味では、これが初めてです。何をしてください。

 #!/usr/bin/env python from distutils.core import setup, Extension pypacks = "C:/Python/Lib/site-packages/" wdkinc = "C:\\Program Files (x86)\\Windows Kits\\10\\Include\\10.0.14393.0\\" wdklib = "C:\\Program Files (x86)\\Windows Kits\\10\\Lib\\10.0.14393.0\\" pywinsrc = "C:/Projects/Source/pywin32-221/" example_module = Extension('_preview', sources=['PyIPreviewHandler.cpp','prtypes.cpp'], include_dirs=[wdkinc + "ucrt", pywinsrc + "com/win32comext/shell/src", pypacks + "win32/include", pypacks + "win32com/include"], library_dirs=[wdklib + "ucrt\\x86", pypacks + "win32/libs", pypacks + "win32com/libs"] ) setup (name = 'preview', version = '0.1', author = "My", description = """Simple swig example from docs""", ext_modules = [example_module], py_modules = ["preview"], )

マシンにWindows SDK（より正確にはWDKがありますが、原則ではありません）とVisual Studio Community 2017が既にあり、setup.pyがそれらを見つけるかどうか疑問に思いました。コンパイラ自体が見つかり、SDKパスを指定する必要がありました。

 C:\Projects\pytest>python.exe setup.py build_ext --inplace >err.txt error: command 'D:\\Program Files (x86)\\Microsoft Visual Studio 14.0\\VC\\BIN\\cl.exe' failed with exit status 2

もちろん、一緒にはなりませんでしたが、初めて収集されるとは思っていませんでした。エラーのクリア：

PyIPreviewHandler.cpp(46): error C3861: 'PyObject_AsCRECTPTR': identifier not found

以前は新しいデータ型を定義していましたが、これらの型のデータをpythonオブジェクトからCに、またはその逆に変換する関数が必要になりました。ソースからPyWin32を検索した後、関数内のPyObject_AsRECT、PyObject_FromRECTなどが、つまり必要なものがすべて見つかりました。これらの機能を使用するには、生成されたオープナーを修正する必要がありました。

それは：

  CRECTPTR prc; PyObject *obprc; ... if (bPythonIsHappy && !PyObject_AsCRECTPTR( obprc, &prc )) bPythonIsHappy = FALSE; ... PyObject_FreeCRECTPTR(prc);

次のようになりました：

  RECT prc; PyObject *obprc; ... if (bPythonIsHappy && !PyObject_AsRECT( obprc, &prc )) bPythonIsHappy = FALSE; ... //PyObject_FreeCRECTPTR(prc);

など、IPreviewHandlerの利点はそれほど多くありません。ただし、変換関数はPyWin32のライブラリに転送されないため、ソースからプルしてprtypes.cppファイルに挿入する必要がありました。

prtypes.cpp

 #include "shell_pch.h" #include "prtypes.h" BOOL PyObject_AsMSG( PyObject *obpmsg, MSG *msg ) { PyObject *obhwnd; return PyArg_ParseTuple(obpmsg, "Oiiii(ii)", &obhwnd,&msg->message,&msg->wParam,&msg->lParam,&msg->time,&msg->pt.x,&msg->pt.y) && PyWinObject_AsHANDLE(obhwnd, (HANDLE *)&msg->hwnd); } PyObject *PyObject_FromMSG(const MSG *msg) { if (!msg) { Py_INCREF(Py_None); return Py_None; } return Py_BuildValue("Niiii(ii)", PyWinLong_FromHANDLE(msg->hwnd),msg->message,msg->wParam,msg->lParam,msg->time,msg->pt.x,msg->pt.y); } BOOL PyObject_AsRECT( PyObject *ob, RECT *r) { return PyArg_ParseTuple(ob, "iiii", &r->left, &r->top, &r->right, &r->bottom); } PyObject *PyObject_FromRECT(const RECT *r) { if (!r) { Py_INCREF(Py_None); return Py_None; } return Py_BuildValue("iiii", r->left, r->top, r->right, r->bottom); }

しかし、今ではソースに頼らずにコンパイルします。コンパイルされますが、アセンブルされません。

 LINK : error LNK2001: unresolved external symbol PyInit__preview build\temp.win32-3.6\Release\_preview.cp36-win32.lib : fatal error LNK1120: 1 unresolved externals

何も言われなかったように感じます。 PyInit_xxx

はモジュールを初期化するための標準名のように見えますが、唯一の質問はその中にあるべきもの、インターフェースの登録方法です。私はPyWin32ソースを再び解き明かし、完全なビルドに必要なものを把握しなければなりませんでした。見つかった関数との類推により、PyInit_xxxは独自の関数を追加しました。

 #include "PythonCOMRegister.h" // For simpler registration of IIDs ... //     static struct PyMethodDef preview_methods[] = {{NULL}}; PyObject *PyInit__preview(void) { static PyModuleDef _preview_def = { PyModuleDef_HEAD_INIT, "_previewer", "Preview Handler Interface", -1, preview_methods }; PyObject *module=PyModule_Create(&_preview_def); //   PyCom_RegisterClientType(&PyIPreviewHandler::type, &IID_IPreviewHandler); return module; }

これで、 _preview.cp36-win32.pyd

ファイル_preview.cp36-win32.pyd

（そして、ここでStirlitzは下線が不要であると推測しました）。結果のパッケージをインストールします。

 C:\Projects\pytest>python.exe setup.py install

チェック-インポート後の同じテストスクリプトで、 import _preview

追加するだけ

スクリプト全体

 <source lang="python">#!/usr/bin/python3 # -*- coding: utf-8 -*- import pythoncom import pywintypes import _preview adobe = pywintypes.IID('{DC6EFB56-9CFA-464D-8880-44885D7DC193}') CLSID_IPreviewHandler = '{8895B1C6-B41F-4C1C-A562-0D564250836F}' iid = pywintypes.IID(CLSID_IPreviewHandler) handler = pythoncom.CoCreateInstance( adobe, None, pythoncom.CLSCTX_LOCAL_SERVER, iid) print(handler)

私は起動して取得します：

 C:\Projects\Python\test>python wincom.py <PyIPreviewHandler at 0x00817770 with obj at 0x00745FFC>

ただし、動作し、オブジェクトは作成されました。

意図した目的で製品を使用することは変わりません。さまざまなドキュメント形式を確認するために、PyQt5のQFileSystemModelとQTreeViewを使用してスクリプトを作成しました。左側にファイルシステムツリーがあり、右側に選択したファイルのプレビューがあります。

スクリプトは次のとおりです。行ごとに解析するのは十分簡単です。IPreviewHandlerを使用する多くのインターネットの例とは異なり、ファイルをメモリに読み込まないか、IInitializeWithFileインターフェイス（存在する場合）を介してビューアで直接開きます。または、標準ストリームを作成します。 SHCreateStreamOnFileEx関数を使用したWinAPI（ PyWin32でもサポートされていることが判明）およびこのストリームをIInitializeWithStreamインターフェイスに渡します-各ビューアーには2つのインターフェイスのいずれかがあります。

filepreview.py

 #!/usr/bin/python3 # -*- coding: utf-8 -*- import pythoncom, win32comext import win32comext.propsys.propsys as propsys import win32comext.shell.shell as shellext import pywintypes import _preview from PyQt5.QtCore import * from PyQt5.QtWidgets import * CLSID_IPreviewHandler = '{8895B1C6-B41F-4C1C-A562-0D564250836F}' iid = pywintypes.IID(CLSID_IPreviewHandler) class PreviewWin(QWidget): def __init__(self, parent=None): super().__init__(parent) self.handler = None self.isFirst = True self.topLay = QHBoxLayout(self) self.splitter = QSplitter(self) self.topLay.addWidget(self.splitter) self.model = QFileSystemModel(self) self.model.setRootPath(QDir.currentPath()) self.tree = QTreeView(self.splitter) self.tree.setModel(self.model) cur = self.model.index(QDir.currentPath()) self.tree.setCurrentIndex(cur) self.tree.expand(cur) self.view = QWidget() self.splitter.addWidget(self.tree) self.splitter.addWidget(self.view) self.tree.clicked.connect(self.previewIndex) self.tree.setColumnWidth(0, 200) self.setWindowState(Qt.WindowMaximized) def resizeEvent(self, event): super().resizeEvent(event) if self.handler: self.handler.SetRect(self.view.rect().getRect()); def previewIndex(self, index): try: if self.handler: self.handler.Unload() self.handler = None if not index.isValid(): return filePath = QDir.toNativeSeparators(self.model.filePath(index)) ext = self.model.fileInfo(index).suffix() regPath = "HKEY_CLASSES_ROOT\\." + ext + "\\shellex\\" + CLSID_IPreviewHandler sets = QSettings(regPath, QSettings.NativeFormat) if not sets.contains("."): return classId = sets.value(".") if not classId: return self.handler = pythoncom.CoCreateInstance(classId, None, pythoncom.CLSCTX_LOCAL_SERVER, iid) if not self.handler: return STGM_READ = 0 try: iwfile = self.handler.QueryInterface(propsys.IID_IInitializeWithFile) except: iwfile = None if iwfile: try: iwfile.Initialize(filePath, STGM_READ) except: iwfile = None if not iwfile: try: iwstream = self.handler.QueryInterface(propsys.IID_IInitializeWithStream) except: print(str(sys.exc_info()[1])) iwstream = None if iwstream: iis = shellext.SHCreateStreamOnFileEx(filePath,STGM_READ,0,False) if iis: iwstream.Initialize(iis, STGM_READ) else: return else: print("Can't initialize preview for",filePath) return r = self.view.rect().getRect() self.handler.SetWindow(self.view.winId(), r); self.handler.DoPreview(); self.handler.SetFocus(); except: print(str(sys.exc_info()[1])) if __name__ == '__main__': import sys app = QApplication(sys.argv) w = PreviewWin() w.show() sys.exit(app.exec_())

すべてのファイルはGithubで折りたたまれています。

Pythonプログラムでドキュメントをプレビューする

More articles: