Archive:Development/Tutorials/KCmdLineArgs (zh TW)
Template:I18n/Language Navigation Bar (zh TW)
Template:TutorialBrowser (zh TW)
摘要
現在我們有了一個可以載入和儲存檔案的文字編輯器。我們要讓這個編輯器像其他桌面程式一樣，能用命令列參數開啟檔案，甚至可以在 Dolphin 裡使用開啟方式來開啟檔案。
程式碼
main.cpp
1 #include <KApplication>
2 #include <KAboutData>
3 #include <KCmdLineArgs>
4 #include <KUrl> //new
5
6 #include "mainwindow.h"
7
8 int main (int argc, char *argv[])
9 {
10 KAboutData aboutData( "tutorial5", "tutorial5",
11 ki18n("Tutorial 5"), "1.0",
12 ki18n("A simple text area which can load and save."),
13 KAboutData::License_GPL,
14 ki18n("Copyright (c) 2007 Developer") );
15 KCmdLineArgs::init( argc, argv, &aboutData );
16
17 KCmdLineOptions options; //新增的
18 options.add("+[file]", ki18n("Document to open")); //新增的
19 KCmdLineArgs::addCmdLineOptions(options); //新增的
20
21 KApplication app;
22
23 MainWindow* window = new MainWindow();
24 window->show();
25
26 KCmdLineArgs *args = KCmdLineArgs::parsedArgs(); //新增的
27 if(args->count()) //新增的
28 {
29 window->openFile(args->url(0).url()); //新增的
30 }
31
32 return app.exec();
33 }
mainwindow.h
1 #ifndef MAINWINDOW_H
2 #define MAINWINDOW_H
3
4 #include <KXmlGuiWindow>
5 #include <KTextEdit>
6
7 class MainWindow : public KXmlGuiWindow
8 {
9 Q_OBJECT
10
11 public:
12 MainWindow(QWidget *parent=0);
13 void openFile(const QString &inputFileName); //新增的
14
15 private:
16 KTextEdit* textArea;
17 void setupActions();
18 QString fileName;
19
20 private slots:
21 void newFile();
22 void openFile();
23 void saveFile();
24 void saveFileAs();
25 void saveFileAs(const QString &outputFileName);
26 };
27
28 #endif
mainwindow.cpp
1 #include "mainwindow.h"
2
3 #include <KApplication>
4 #include <KAction>
5 #include <KLocale>
6 #include <KActionCollection>
7 #include <KStandardAction>
8 #include <KFileDialog>
9 #include <KMessageBox>
10 #include <KIO/NetAccess>
11 #include <KSaveFile>
12 #include <QTextStream>
13
14 MainWindow::MainWindow(QWidget *parent)
15 : KXmlGuiWindow(parent),
16 fileName(QString())
17 {
18 textArea = new KTextEdit;
19 setCentralWidget(textArea);
20
21 setupActions();
22 }
23
24 void MainWindow::setupActions()
25 {
26 KAction* clearAction = new KAction(this);
27 clearAction->setText(i18n("Clear"));
28 clearAction->setIcon(KIcon("document-new"));
29 clearAction->setShortcut(Qt::CTRL + Qt::Key_W);
30 actionCollection()->addAction("clear", clearAction);
31 connect(clearAction, SIGNAL(triggered(bool)),
32 textArea, SLOT(clear()));
33
34 KStandardAction::quit(kapp, SLOT(quit()),
35 actionCollection());
36
37 KStandardAction::open(this, SLOT(openFile()),
38 actionCollection());
39
40 KStandardAction::save(this, SLOT(saveFile()),
41 actionCollection());
42
43 KStandardAction::saveAs(this, SLOT(saveFileAs()),
44 actionCollection());
45
46 KStandardAction::openNew(this, SLOT(newFile()),
47 actionCollection());
48
49 setupGUI();
50 }
51
52 void MainWindow::newFile()
53 {
54 fileName.clear();
55 textArea->clear();
56 }
57
58 void MainWindow::saveFileAs(const QString &outputFileName)
59 {
60 KSaveFile file(outputFileName);
61 file.open();
62
63 QByteArray outputByteArray;
64 outputByteArray.append(textArea->toPlainText());
65 file.write(outputByteArray);
66 file.finalize();
67 file.close();
68
69 fileName = outputFileName;
70 }
71
72 void MainWindow::saveFileAs()
73 {
74 saveFileAs(KFileDialog::getSaveFileName());
75 }
76
77 void MainWindow::saveFile()
78 {
79 if(!fileName.isEmpty())
80 {
81 saveFileAs(fileName);
82 }
83 else
84 {
85 saveFileAs();
86 }
87 }
88
89 void MainWindow::openFile() //變更
90 {
91 openFile(KFileDialog::getOpenFileName());
92 }
93
94 void MainWindow::openFile(const QString &inputFileName) //新增的
95 {
96 QString tmpFile;
97 if(KIO::NetAccess::download(inputFileName, tmpFile,
98 this))
99 {
100 QFile file(tmpFile);
101 file.open(QIODevice::ReadOnly);
102 textArea->setPlainText(QTextStream(&file).readAll());
103 fileName = inputFileName;
104
105 KIO::NetAccess::removeTempFile(tmpFile);
106 }
107 else
108 {
109 KMessageBox::error(this,
110 KIO::NetAccess::lastErrorString());
111 }
112 }
tutorial5ui.rc
1 <?xml version="1.0" encoding="UTF-8"?>
2 <gui name="tutorial5"
3 version="1"
4 xmlns="http://www.kde.org/standards/kxmlgui/1.0"
5 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
6 xsi:schemaLocation="http://www.kde.org/standards/kxmlgui/1.0
7 http://www.kde.org/standards/kxmlgui/1.0/kxmlgui.xsd" >
8
9 <MenuBar>
10 <Menu name="file" >
11 <Action name="clear" />
12 </Menu>
13 </MenuBar>
14
15 <ToolBar name="mainToolBar" >
16 <text>Main Toolbar</text>
17 <Action name="clear" />
18 </ToolBar>
19
20 </gui>
這和前兩個教學的 tutorialxui.rc 一樣，唯一的改變就是從 tutorialx 變成了tutorial5。
解釋
mainwindow.h
這裡我們只新增 openFile 函式，它接受一個 QString 作為參數。
void openFile(const QString &inputFileName);
mainwindow.cpp
這部分沒有新增程式碼，只是重新整理一下而已。所有 void openFile() 裡的東西都被移到了 void openFile(const QString &inputFileName) 裡，除了 KFileDialog::getOpenFileName() 的呼叫。
這樣，如果我們要一個對話框就呼叫 openFile()，如果已經有檔案名稱，呼叫openFile(QString) 就可以了。
main.cpp
This is where all the KCmdLineArgs magic happens.
編譯、安裝與執行
CMakeLists.txt
1 project(tutorial5)
2
3 find_package(KDE4 REQUIRED)
4 include_directories( ${KDE4_INCLUDES} )
5
6 set(tutorial5_SRCS
7 main.cpp
8 mainwindow.cpp
9 )
10
11 kde4_add_executable(tutorial5 ${tutorial5_SRCS})
12
13 target_link_libraries(tutorial5 ${KDE4_KDEUI_LIBS}
14 ${KDE4_KIO_LIBS})
15
16 install(TARGETS tutorial5 DESTINATION ${BIN_INSTALL_DIR})
17 install( FILES tutorial5ui.rc
18 DESTINATION ${DATA_INSTALL_DIR}/tutorial5 )
有了這個檔案，這個教學就可以像教學3和4一樣建構和執行了。更多資訊，請見教學3。
mkdir build && cd build cmake .. -DCMAKE_INSTALL_PREFIX=$HOME make install $HOME/bin/tutorial5
繼續前進
現在你可以開始學習下一課：### (TODO User:milliams) 教學。
This page was last edited on 23 June 2013, at 15:16. Content is available under Creative Commons License SA 4.0 unless otherwise noted.