From fc52997a3acbb6060b6202c398c747d367cd0d0b Mon Sep 17 00:00:00 2001 From: shen Date: Mon, 29 Jun 2026 16:16:50 +0800 Subject: [PATCH] Add PDF file association settings --- README.md | 1 + docs/development_plan.md | 1 + pdfreaderlite/core/file_association.py | 44 +++++++++++++++++++++++++ pdfreaderlite/ui/main_window.py | 45 +++++++++++++++++++++++++- 4 files changed, 90 insertions(+), 1 deletion(-) create mode 100644 pdfreaderlite/core/file_association.py diff --git a/README.md b/README.md index 9bba804..aa4a57d 100644 --- a/README.md +++ b/README.md @@ -55,6 +55,7 @@ PDFReaderLite 是一个面向 Windows 的轻量 PDF 阅读与编辑工具,目 - 快捷键说明 - 打开日志目录 - exe 版本资源 +- 设置中注册 PDF 文件关联 - 图片签名 - 深色模式 - 常用快捷键 diff --git a/docs/development_plan.md b/docs/development_plan.md index 571f949..30910bb 100644 --- a/docs/development_plan.md +++ b/docs/development_plan.md @@ -58,6 +58,7 @@ PDFReaderLite 是 Windows 平台的轻量 PDF 阅读与编辑工具。功能重 - 打印(已完成) - 多标签页 - 深色模式(已完成) +- PDF 文件关联(已完成当前用户级注册与系统默认应用入口) ## V4:打包与体验优化 diff --git a/pdfreaderlite/core/file_association.py b/pdfreaderlite/core/file_association.py new file mode 100644 index 0000000..983514b --- /dev/null +++ b/pdfreaderlite/core/file_association.py @@ -0,0 +1,44 @@ +from __future__ import annotations + +import sys +import winreg +from pathlib import Path + + +PROG_ID = "PDFReaderLite.pdf" + + +def current_launcher() -> str: + if getattr(sys, "frozen", False): + return f'"{Path(sys.executable)}" "%1"' + return f'"{Path(sys.executable)}" "{Path(sys.argv[0]).resolve()}" "%1"' + + +def register_pdf_association(icon_path: str | Path) -> None: + command = current_launcher() + icon = str(Path(icon_path)) + + with winreg.CreateKey(winreg.HKEY_CURRENT_USER, r"Software\Classes\.pdf") as key: + winreg.SetValueEx(key, "", 0, winreg.REG_SZ, PROG_ID) + + with winreg.CreateKey(winreg.HKEY_CURRENT_USER, rf"Software\Classes\{PROG_ID}") as key: + winreg.SetValueEx(key, "", 0, winreg.REG_SZ, "PDFReaderLite PDF 文档") + + with winreg.CreateKey( + winreg.HKEY_CURRENT_USER, + rf"Software\Classes\{PROG_ID}\DefaultIcon", + ) as key: + winreg.SetValueEx(key, "", 0, winreg.REG_SZ, icon) + + with winreg.CreateKey( + winreg.HKEY_CURRENT_USER, + rf"Software\Classes\{PROG_ID}\shell\open\command", + ) as key: + winreg.SetValueEx(key, "", 0, winreg.REG_SZ, command) + + +def unregister_pdf_association() -> None: + try: + winreg.DeleteTree(winreg.HKEY_CURRENT_USER, rf"Software\Classes\{PROG_ID}") + except FileNotFoundError: + pass diff --git a/pdfreaderlite/ui/main_window.py b/pdfreaderlite/ui/main_window.py index b2653bf..69163b0 100644 --- a/pdfreaderlite/ui/main_window.py +++ b/pdfreaderlite/ui/main_window.py @@ -27,8 +27,12 @@ from PySide6.QtWidgets import ( ) from pdfreaderlite import __version__ +from pdfreaderlite.core.file_association import ( + register_pdf_association, + unregister_pdf_association, +) from pdfreaderlite.core.document import EncryptedPdfError, FormField, PdfDocument, SearchMatch -from pdfreaderlite.resources import software_icon_path +from pdfreaderlite.resources import pdf_icon_path, software_icon_path from pdfreaderlite.ui.pdf_viewer import PdfViewer from pdfreaderlite.ui.sidebar import Sidebar from pdfreaderlite.ui.signature_dialog import SignatureDialog @@ -742,6 +746,14 @@ class MainWindow(QMainWindow): tools_menu.addAction(self.form_fill_action) tools_menu.addAction(self.annotation_list_action) + settings_menu = self.menuBar().addMenu("设置") + self.register_pdf_action = QAction("注册 PDF 文件关联", self) + self.unregister_pdf_action = QAction("取消 PDF 文件关联注册", self) + self.default_apps_action = QAction("打开系统默认应用设置", self) + settings_menu.addAction(self.register_pdf_action) + settings_menu.addAction(self.unregister_pdf_action) + settings_menu.addAction(self.default_apps_action) + edit_menu = self.menuBar().addMenu("编辑") edit_menu.addAction(self.undo_action) edit_menu.addAction(self.redo_action) @@ -840,6 +852,9 @@ class MainWindow(QMainWindow): self.metadata_action.triggered.connect(self.edit_metadata) self.form_fill_action.triggered.connect(self.fill_form_field) self.annotation_list_action.triggered.connect(self.show_annotations) + self.register_pdf_action.triggered.connect(self.register_pdf_file_association) + self.unregister_pdf_action.triggered.connect(self.unregister_pdf_file_association) + self.default_apps_action.triggered.connect(self.open_default_apps_settings) self.highlight_action.triggered.connect(self.highlight_current_page) self.underline_action.triggered.connect(self.underline_current_page) self.strikeout_action.triggered.connect(self.strikeout_current_page) @@ -1119,6 +1134,34 @@ class MainWindow(QMainWindow): log_dir.mkdir(parents=True, exist_ok=True) QDesktopServices.openUrl(QUrl.fromLocalFile(str(log_dir))) + def register_pdf_file_association(self) -> None: + try: + register_pdf_association(pdf_icon_path()) + QMessageBox.information( + self, + "PDF 文件关联", + "已注册 PDFReaderLite 的 PDF 文件关联信息。\n\n" + "Windows 可能仍需要你在系统默认应用设置中确认默认 PDF 应用。", + ) + self.open_default_apps_settings() + except Exception as exc: + QMessageBox.critical(self, "注册失败", f"无法注册 PDF 文件关联:\n{exc}") + + def unregister_pdf_file_association(self) -> None: + try: + unregister_pdf_association() + QMessageBox.information( + self, + "PDF 文件关联", + "已移除 PDFReaderLite 的 PDF 文件关联注册信息。\n\n" + "如果系统默认应用仍显示 PDFReaderLite,请在 Windows 默认应用设置中重新选择。", + ) + except Exception as exc: + QMessageBox.critical(self, "取消失败", f"无法取消 PDF 文件关联注册:\n{exc}") + + def open_default_apps_settings(self) -> None: + QDesktopServices.openUrl(QUrl("ms-settings:defaultapps")) + def show_shortcuts(self) -> None: QMessageBox.information( self,