【VS Code 与 Qt6】QAction 类的一些事
QAction 類表示用戶命令的一種抽象,包括命令文本、圖標、命令觸發后要執行的代碼。菜單、工具欄按鈕往往存在相同的功能,將這些命令獨立抽出來,放到 QAction 以象上,可避免編寫重復的代碼。比如“文件”菜單下有“保存”命令,工具欄上也會有“保存”按鈕。因此,創建一個表示“保存”的 QAction 對象,同時添加到菜單和工具欄中,它們就能共享相同的功能。
以上F話了這么多,就是為了明確 QAction 類的作用。在創建 QAction 實例時,可以通過構造函數傳遞命令的文本,或圖標。如果在調用構造函數時不指定,那么可以用下面這些方法來“補做”:
1、setText 方法:設置命令文本。顯示在用戶界面上的文本;
2、setIcon 方法:看名識義,就是設置圖標;
3、setFont 方法:在呈現命令文本時用的字體。一般不需要特意去指定字體,它會繼承應用程序的默認字體;
4、setShortcut:設置命令的快捷鍵。
QAction 類有個核心的信號:triggered,當用戶通過點擊或快捷鍵激活菜單項或工具欄按鈕,就會發出 triggered 信號。
下面咱們做個簡單的例子。這里我用到了 QMainWindow 類來充當主窗口,因為它的“窗口功能”比較完善,創建個菜單欄、工具欄和狀態欄的都比較方便。
CMake 文件:
cmake_minimum_required(VERSION 3.20)
# 項目
project(myApp VERSION 1.0.0 LANGUAGES CXX)
find_package(Qt6 REQUIRED COMPONENTS Gui Core Widgets)
# 開啟MOC
set(CMAKE_AUTOMOC ON)
# 語言標準
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON) # 源文件
add_executable(app WIN32 me.cpp)
target_link_libraries(app PRIVATE Qt6::Core Qt6::Gui Qt6::Widgets)
me.cpp 文件:
#include <QApplication>
#include <QMainWindow>
#include <QMenuBar>
#include <QMessageBox>
#include <QMenu>
#include <QAction>
#include <QIcon> // 這三個逗丁用來接收信號的,slot 函數
void onNew();
void onSave();
void onExit(); int main(int argc, char** argv)
{
QApplication app(argc,argv);
// 創建主窗口
QMainWindow win;
// 窗口標題
win.setWindowTitle("整活兒");
// 這樣獲取,默認會創建空的菜單欄
QMenuBar* menubar = win.menuBar();
// 添加“文件”菜單
QMenu* fileMenu = menubar -> addMenu("文件");
// 創建三個QAction對象
QAction *act1 = new QAction("新建", &win);
QAction *act2 = new QAction("保存", &win);
QAction *act3 = new QAction("退出", &win);
// 連接triggered信號
QObject::connect(act1, &QAction::triggered, &onNew);
QObject::connect(act2, &QAction::triggered, &onSave);
QObject::connect(act3, &QAction::triggered, &onExit);
// 把三個action添加到菜單中
fileMenu->addAction(act1);
fileMenu->addAction(act2);
fileMenu->addAction(act3); // 顯示主窗口
win.show();
// 進入事件循環
return QApplication::exec();
} void onNew()
{
QMessageBox::information(nullptr, "提示", "新建文件");
} void onSave()
{
QMessageBox::information(nullptr, "提示", "保存文件");
} void onExit()
{
QApplication::exit();
}
QMainWindow 的 menuBar 方法用來獲取菜單欄(QMenuBar)引用的。但,當窗口中未設置過菜單欄時,它會自動創建一個空菜單欄,并將其引用返回。返回的 QMenu 對象表示菜單,調用它的 addAction 方法就能添加菜單項了。菜單項用 QAction 表示。
onNew、onSave、onExit 這三個函數分別作為三個 QAction 對象的 slot 函數,接收 triggered 信號。
運行后,你會看到,QAction 對象指定的文本,會自動呈現在菜單文本中。
通常,為了讓菜單命令更直觀,咱們會在重要的菜單項上加上圖標。接下來給上述三個 action 添上小圖標。這里老周介紹一個獲取圖標的網站,很好用,要啥圖標,進去后直接搜索就行,而且可以選擇多尺寸下載。比那些要強制登錄才能用的騷站好很多。
瀏覽器打開 Download 1,301,500 free icons (SVG, PNG) (icons8.com)
菜單上的圖標,用 16×16 就夠了。把圖標文件放在與應用程序可執行文件相同的路徑下,依次命名為 new.png、save.png、exit.png。
接著,改一下代碼,需要用 QAction 帶 QIcon 參數的構造函數。
QAction *act1 = new QAction(QIcon("new.png"), "新建", &win);
QAction *act2 = new QAction(QIcon("save.png"), "保存", &win);
QAction *act3 = new QAction(QIcon("exit.png"), "退出", &win);
再次編譯,運行,效果如下:
對于常用的命令,有快捷鍵能大大提升效率。快捷鍵需要用到 QKeySequence 類。該類在 QtGui 基礎模塊中。這個類在調用構造函數時有一種特特簡單的用法,就是直接用字符串來描述快捷鍵。這些字符要求是人類可讀性較高的。比如下面這些:
Ctrl+F // Ctrl + F
Shift+H // Shift+ H
Alt+W
Ctrl+Alt+E
F5 // 就是 F5
D // 就是字母D
給上面示例的三個菜單加上快捷鍵。
act1->setShortcut(QKeySequence("Ctrl+N"));
act2->setShortcut(QKeySequence("ctrl+S"));
act3->setShortcut(QKeySequence("Alt+E"));
描述按鍵的字符串不區分大小寫,所以,“Alt+E”和“alt+e”一樣。快捷鍵會顯示在菜單命令文本的右邊。如下所示
這時候,只要按下 Alt + E,程序就會退出。
應用程序除了菜單欄,通常還有工具欄(QToolBar)。QAction 類是命令的抽象,它可以在菜單欄與工具欄之間共用。所以,咱們上面的示例也可以加上工具欄。
// 創建三個QAction對象
QAction *act1 = new QAction(QIcon("new.png"), "新建", &win);
QAction *act2 = new QAction(QIcon("save.png"), "保存", &win);
QAction *act3 = new QAction(QIcon("exit.png"), "退出", &win);
……
// 創建工具欄
QToolBar *toolbar = new QToolBar(&win);
// 將那三個命令添加到工具欄
toolbar->addAction(act1);
toolbar->addAction(act2);
toolbar->addAction(act3);
// 工具欄添加到主窗口
win.addToolBar(toolbar);
重新編譯運行,結果如下:
QAction 的 triggered 信號是這樣定義的:
void QAction::triggered(bool checked = false)
它有個 bool 類型的參數,默認是 false。干嗎用的呢?這是處理帶 check 功能的菜單用的。就是那種點一下 on,再點一下 off 的那種。咱們在上面的示例中增加一個“開機啟動”菜單項。
QAction *act4 = new QAction("開機啟動", &win);
// 開啟check功能
act4->setCheckable(true);
QObject::connect(act4, &QAction::triggered, &onAutoStart);
fileMenu->addAction(act4);
// 這個是slot函數
void onAutoStart(bool checked)
{
if(checked){
QMessageBox::information(nullptr,"提示", "程序開機啟動");
}
else
{
QMessageBox::information(nullptr,"提示","已取消開機啟動");
}
}
setCheckable 方法如果傳遞 true,表示開啟 check 功能;若 false,關閉 check 功能。
當可check菜單處于 on 狀態時,它前面會顯示一個勾。如下圖所示:
有些時候,菜單命令的默認用戶界面不太符合需要。為了方便用戶操作,我可能想放一個別的 Widget 上去(比如放個滑塊條)。QAction 類做不到這個,但它的派生類可以:QWidgetAction。
咱們在菜單欄上添加一個顯示 QSpinBox 組件的命令。
// 創建spinBox組件
QSpinBox *spinbox = new QSpinBox(&win);
spinbox->show();
// 設置一下范圍0-300
spinbox->setRange(0, 300);
// 默認顯示的值50
spinbox->setValue(50);
// 將它放到工具欄和菜單上
QWidgetAction *act5 = new QWidgetAction(&win);
act5->setDefaultWidget(spinbox); fileMenu->addAction(act5);
QWidgetAction 在實例化后,調用 setDefaultWidget 方法關聯要顯示在菜單上的組件即可。當然,咱們可以從 QWidgetAction 類派生出自己的類,來實現更高級的需求。這個老周留到下次寫水文時再說。
編譯運行,看看菜單的最后一項,有趣吧。
==========================================================================
好了,今天的話題就聊完了。下面又是老周講故事時間。
以前老周分享過改 VS Code 全窗口背景的方法,就是設置 <body> 元素的背景圖,然后適當調一調透明度。
但,如果你不喜歡那樣覆蓋整個窗口,我只是想打開代碼編輯器時才看到背景圖呢。嗯,也就是只設置編輯器的背景圖。原理一樣,都是改 CSS 樣式。打開VS Code程序目錄下的 resources\app\out\vs\workbench\workbench.desktop.main.css 樣式表,添加以下樣式:
.monaco-editor, .monaco-editor-background {
background: center/32% no-repeat url('vscode-file://vscode-app/c:/users/mmm/pictures/bg/20.png') !important;
}
對的,就是設置 background 屬性,后面的 important 表示強行覆蓋,不然不會生效。圖片URL 是 vscode-file 協議,加上 vscode-app 前綴,然后就是圖片的完整路徑。center/32% 表示圖片居中對齊,32% 是縮小圖片,變為原尺寸的32%,這個你得根據你的圖片自己調,調到合適就好。
建議使用透明背景的 PNG 圖片,因為太花的圖片會干擾你寫代碼的。CSS 不要用 opacity 來調整透明度,因為這樣一調,連代碼的透明度也跟著變了,很影響視線,看不清代碼,容易導致高度近視。咱們可以在圖片上做手腳,就是讓原圖也具有一定的透明度。
方法是用 PS 打開圖片,在圖層面板的“不透明度”,改為 15-20% ,具體哪個值你也可以試試,只要看著舒服就行。
設置完后,效果如下:
《初代萌王陪我寫代碼》,豈不美哉!
總結
以上是生活随笔為你收集整理的【VS Code 与 Qt6】QAction 类的一些事的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: (已解决)nginx+tp,怎么设置 省
- 下一篇: VUE学习-:class & :