Archive:Development/Tutorials/KCmdLineArgs (zh TW)

Jump to: navigation, search

Template:I18n/Language Navigation Bar (zh TW)

Template:TutorialBrowser (zh TW)

Contents

摘要

現在我們有了一個可以載入和儲存檔案的文字編輯器。我們要讓這個編輯器像其他桌面程式一樣,能用命令列參數開啟檔案,甚至可以在 Dolphin 裡使用開啟方式來開啟檔案。

Introtokdetutorial5.png

程式碼

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 modified on 23 June 2013, at 16:16. This page has been accessed 3,376 times. Content is available under Creative Commons License SA 3.0 as well as the GNU Free Documentation License 1.2.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal