桌面应用【免费下载链接】QOwnNotesQOwnNotes is a plain-text file notepad and todo-list manager with Markdown support and Nextcloud / ownCloud integration.项目地址https://gitcode.com/gh_mirrors/qo/QOwnNotes点击查看免费下载QOwnNotes 基于 Qt 的停靠面板dock widget与中央部件central widget机制构建界面允许你将任意面板提升为占据主区域的自适应中央区域。本文基于官方 FAQ 与源码详细介绍如何通过Settings Interface Layouts布局设置让笔记预览面板Note preview独占主窗口中央区域、隐藏笔记编辑面板实现只读浏览 快速翻阅的纯预览模式并深入解析底层实现原理。一、先理解 QOwnNotes 的界面组成面板与中央部件QOwnNotes 的主窗口由两部分构成停靠面板Dock Widgets笔记列表note list、标签tagging、笔记预览Note preview、笔记编辑Note edit、日志、脚本等面板默认停靠在窗口四周可以浮动、移动、折叠中央部件Central Widget占据窗口剩余空间的核心区域会自动吸收周围面板腾出的空间并自适应缩放。从源码看主窗口维护了两个布尔标志_noteEditIsCentralWidget与_notePreviewIsCentralWidgetcentralWidgetIdentifier()据此返回三种取值之一note-edit笔记编辑面板作为中央部件默认note-preview笔记预览面板作为中央部件none没有中央部件所有面板均为普通停靠面板。详见 src/mainwindow.cpp#L1356-L1434。setCentralWidgetIdentifier()负责在三种状态间切换切换时会先把原先位于中央的noteEditTabWidget或noteViewFrame从中央区域取下、重新包装成QDockWidget再把目标组件setCentralWidget()设为中央部件整个过程不会丢失任何面板状态。二、方式一使用内置 Preview only 预设推荐官方 FAQ 推荐的最快路径是利用内置的Preview only仅预览布局预设打开设置Settings 界面Interface 布局Layouts点击Add from preset...从预设添加…按钮在弹出的预设选择对话框中选中Preview only仅预览点击Use new layout preset使用新布局预设确认。Preview only预设的完整定义记录在布局预设配置文件 src/configurations/layouts.ini#L17-L22 中[LayoutPreset-preview-only] screenshotpreview-only.png noteSubFolderDockWidgetVisibletrue centralWidgetnote-preview noteEditIsCentralWidgetfalse其中centralWidgetnote-preview意味着预览面板自动成为中央部件noteEditIsCentralWidgetfalse说明笔记编辑面板不再是中央部件、只以普通停靠面板形式存在。该预设默认启用左侧笔记列表、标签等面板右侧仅保留预览面板。官方预设描述src/widgets/layoutpresetwidget.cpp#L197-L203特别提醒You will need another layout to actually edit notes!—— 即该布局下没有可见的编辑入口若需编辑笔记必须切换回其他布局见第五节。三、方式二手动新建布局并指定中央部件如果你不想要整套预设也可以基于当前界面微调打开设置 界面 布局点击Add from current从当前添加把当前面板排布复制为一个新布局会弹出对话框要求输入布局名称在布局列表中选中该新布局在下方Selected layout所选布局分组中将Central widget中央部件下拉框从默认的Note edit笔记编辑改为Note preview笔记预览。该下拉框的三个选项直接对应三种中央部件取值src/widgets/settings/layoutssettingswidget.cpp#L84-L93下拉框选项底层标识符效果Note edit笔记编辑note-edit编辑区占中央预览停靠在右侧Note preview笔记预览note-preview预览占中央编辑区变为普通停靠面板No central widget无中央部件none无自动缩放区域各面板自由排列修改会立即生效setLayoutCentralWidget()在所选布局就是当前布局时会同步更新全局设置并调用setCentralWidgetIdentifier()实时切换界面src/managers/layoutmanager.cpp#L403-L423。四、关闭笔记编辑面板让预览占据全部空间无论采用哪种方式最后一步都是在窗口Window 面板Panels菜单中取消勾选Show Note edit panel显示笔记编辑面板让编辑面板隐藏。面板菜单是动态生成的updatePanelMenu()遍历所有QDockWidget为每个面板生成一个 Show %1 panel 形式的可勾选菜单项src/mainwindow.cpp#L1769-L1813。勾选状态即面板的显示状态取消勾选后笔记编辑面板被隐藏原本被它占据的空间释放出来由于预览面板已是中央部件它会自动吸收中央区域的全部剩余空间实现全窗口仅预览的效果。面板的显示/隐藏操作会通过storeCurrentLayout()持久化到当前布局中src/mainwindow.cpp#L1842-L1884因此关闭编辑面板的偏好会保存在该布局内下次切换回此布局时仍然生效。提示Preview only预设的 windowState 数据src/configurations/layouts.ini 中的ByteArray(...)内容已内置了面板的初始位置与尺寸因此从该预设创建布局后通常连编辑面板的停靠位置都是现成的只需按需微调。五、随时切换回编辑模式布局切换机制纯预览模式下无法编辑笔记但 QOwnNotes 的布局系统支持一键来回切换主窗口工具栏有一个布局下拉框Layouts combo box列出所有已保存布局布局也会出现在主菜单窗口 布局Window Layouts中且支持为每个布局单独绑定快捷键设置键Shortcuts/MainWindow-restoreLayout-UUID。切换时LayoutManager::setCurrentLayout()会先保存当前布局状态再恢复目标布局的 windowState 与中央部件设置src/managers/layoutmanager.cpp#L132-L167。此外布局切换还会触发脚本钩子layoutSwitchedHooksrc/managers/layoutmanager.cpp#L166脚本作者可以借此在进入仅预览模式时自动执行自定义动作。因此推荐实践是保留两个布局——一个Full默认全功能含编辑面板一个Preview only纯预览阅读时切到预览、需要写作时切回 Full。六、解锁面板自由移动与任意调整大小FAQ 原文特别提醒主菜单窗口 解锁面板Window Unlock panels可以解除面板锁定之后所有面板都可以自由拖动、重新停靠、调整大小。解锁面板的底层逻辑src/managers/layoutmanager.cpp#L522-L560默认锁定状态下每个非浮动的停靠面板的标题栏会被替换为空白QWidget面板无法被拖动handleDockWidgetLocking()并在 Linux 下给面板内容加 3px 上边距勾选解锁面板后restoreDockWidgetTitleBars()恢复各面板原始标题栏面板即可自由拖拽与停靠面板解锁状态下的每一次移动同样会在切换布局时被保存。若面板被拖成浮动窗口后无法手动重新停靠可使用窗口 重新停靠面板Window Reattach panels一键恢复src/managers/layoutmanager.cpp#L587-L602。七、面板与布局的持久化配置都存到哪里所有布局与面板状态都通过SettingsService写入 QSettings配置键含义layouts全部布局 UUID 列表currentLayout/previousLayout当前布局 / 上一个布局用于切换到上一布局layout-UUID/name布局名称layout-UUID/centralWidget该布局的中央部件note-edit/note-preview/nonelayout-UUID/noteEditIsCentralWidget兼容标志等于centralWidget note-editlayout-UUID/windowState各面板位置、尺寸与可见性的序列化状态layout-UUID/noteSubFolderDockWidgetVisible笔记子文件夹面板可见性具体读写逻辑见 src/managers/layoutmanager.cpp#L172-L193storeCurrentLayout与 src/managers/layoutmanager.cpp#L198-L283restoreCurrentLayout。另外设置页面的布局管理操作添加、重命名、删除、排序、切换、设置中央部件都会即时生效并立即持久化无需额外保存。八、注意事项与常见问题纯预览布局不能编辑笔记Preview only预设不显示编辑面板写笔记前需切换回含编辑面板的布局如Full、Minimal预设它们均为centralWidgetnote-edit见 src/configurations/layouts.ini。至少保留两个布局删除布局受保护当仅剩一个布局时 Remove移除 按钮会被禁用src/managers/layoutmanager.cpp#L116-L117这从机制上防止你把自己锁死在无法编辑的布局里。首次启动的默认布局首次运行时restoreCurrentLayout()会自动创建full与minimal两个布局src/managers/layoutmanager.cpp#L203-L216随后你添加的布局会排在其后。中央部件宽度自适应预览作为中央部件时窗口缩放时它会自动占满剩余区域而普通停靠的预览面板在窗口较窄时会被限制在width() / 3内src/mainwindow.cpp#L1286-L1288这也是仅预览模式阅读体验更好的原因之一。九、相关参考英文原版 FAQwebpage/src/faq/preview-without-edit.md本文所讲内容即由此文档展开布局预设定义src/configurations/layouts.ini布局管理器切换 / 保存 / 恢复 / 增删改src/managers/layoutmanager.cpp布局设置界面中央部件下拉框、Add from current、Add from preset...src/widgets/settings/layoutssettingswidget.cpp预设选择部件预设名称、描述与缩略图加载src/widgets/layoutpresetwidget.cpp主窗口面板 / 中央部件切换实现src/mainwindow.cpp设置对话框界面定义Interface Layouts 页面src/dialogs/settingsdialog.ui布局预设截图目录src/images/layouts/preview-only.png赞分享桌面应用【免费下载链接】QOwnNotesQOwnNotes is a plain-text file notepad and todo-list manager with Markdown support and Nextcloud / ownCloud integration.项目地址https://gitcode.com/gh_mirrors/qo/QOwnNotes点击查看免费下载相关推荐QOwnNotes 仅预览模式配置指南隐藏笔记编辑面板只显示 Markdown 预览QOwnNotes 仅预览模式配置指南隐藏笔记编辑面板只显示 Markdown 预览 本篇指南讲解如何在 QOwnNotes 中只显示笔记预览Note p桌面应用QOwnNotes 布局实战如何只显示笔记预览面板而不显示编辑面板QOwnNotes 布局实战如何只显示笔记预览面板而不显示编辑面板 本篇技术指南讲解 QOwnNotes 中一种非常实用的界面布局玩法 让主窗口只保留笔记预桌面应用QOwnNotes 纯预览模式配置指南隐藏笔记编辑面板、只保留预览视图QOwnNotes 纯预览模式配置指南隐藏笔记编辑面板、只保留预览视图 本文基于 QOwnNotes 官方 FAQ 文档 webpage/src/faq/p桌面应用上一篇QueryExcel5分钟搞定上百个Excel文件的批量查询终极指南下一篇bat 安装指南3 步装好这个命令行文件查看神器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考