Development/Tutorials/Using KXmlGuiWindow/pt-br: Difference between revisions

    From KDE TechBase
    (Created page with "Para realmente executar esta janela, precisamos adicionar algumas linhas em main.cpp:")
    (Updating to match new version of source page)
     
    (7 intermediate revisions by one other user not shown)
    Line 125: Line 125:
    </syntaxhighlight>
    </syntaxhighlight>


    Again, we include our new header file in order to create our MainWindow object which we then display.
    Novamente, incluímos nosso novo arquivo de cabeçalho para criar nosso objeto MainWindow, que então exibimos.


    ==CMake==
    ==CMake==


    The best way to build the program is to use CMake. We add <tt>mainwindow.cpp</tt> to the sources list, include the XmlGui and TextWidgets (for KTextEdit) frameworks, and replace all <tt>tutorial1</tt> text to <tt>tutorial2</tt>.
    A melhor maneira de criar o programa é usar o CMake. Nós adicionamos <tt>mainwindow.cpp</tt> à lista de fontes, incluímos as estruturas XmlGui e TextWidgets (para o KTextEdit) e substituímos todo o texto <tt>tutorial1</tt> por <tt>tutorial2</tt>.


    ===CMakeLists.txt===
    ===CMakeLists.txt===
    Line 142: Line 142:


    find_package(ECM 1.0.0 REQUIRED NO_MODULE)
    find_package(ECM 1.0.0 REQUIRED NO_MODULE)
    set(CMAKE_MODULE_PATH ${ECM_MODULE_PATH} ${ECM_KDE_MODULE_DIR} ${CMAKE_CURRENT_SOURCE_DIR}/cmake)
    set(CMAKE_MODULE_PATH ${ECM_MODULE_PATH} ${CMAKE_CURRENT_SOURCE_DIR}/cmake)


    include(KDEInstallDirs)
    include(KDEInstallDirs)
    Line 178: Line 178:
    </syntaxhighlight>
    </syntaxhighlight>


    === Compile and run ===
     
    The best way to compile, link and run it is to [[Getting_Started/Build|set up a correct build environment]]. But for a simple tutorial like this, it's enough to just create a build directory and build from there. This command takes cafe of all of that in one line:
    === Compilar e executar ===
    A melhor maneira de compilar, linkar e executar é [[Getting_Started/Build|configurar um ambiente de compilação correto]]. Mas, para um tutorial simples como este, basta criar um diretório de compilação e compilar a partir daí. Este comando faz tudo isso em uma linha:
    <syntaxhighlight lang="bash">
    <syntaxhighlight lang="bash">
    mkdir build && cd build && cmake .. && make && ./tutorial2
    mkdir build && cd build && cmake .. && make && ./tutorial2
    </syntaxhighlight>
    </syntaxhighlight>


    ==Moving On==
    ==Adiante==
    Now you can move on to [[Development/Tutorials/Using_Actions|Using Actions]].
    Agora você pode seguir para [[Development/Tutorials/Using_Actions|Usando Actions]].


    [[Category:C++]]
    [[Category:C++]]

    Latest revision as of 16:44, 24 August 2020

    Other languages:
    Como usar a KXmlGuiWindow
    Tutorial Series   Tutorial para Iniciantes
    Previous   Tutorial 1 - Hello World
    What's Next   Tutorial 3 - QActions and XMLGUI
    Further Reading   KXmlGuiWindow

    Resumo

    Este tutorial incrementa o First Program Tutorial e apresentará a classe KXmlGuiWindow.

    No tutorial anterior o programa fez aparecer uma caixa de diálogo, então vamos dar passos no sentido de criar um aplicativo funcional.


    KXmlGuiWindow

    A KXmlGuiWindow fornece uma visualização completa da janela principal com menus, barras de ferramentas, uma barra de status e uma área principal no centro para um widget grande. Por exemplo, o menu de ajuda é predefinido. A maioria dos aplicativos KDE deriva dessa classe, pois fornece uma maneira fácil de definir layouts de menus e barras de ferramentas por meio de arquivos XML (essa tecnologia é chamada XMLGUI e faz parte da estrutura KF5::XmlGui). Embora não utilizemos XMLGUI neste tutorial, vamos usá-lo no próximo.

    Para ter uma KXmlGuiWindow útil, precisamos criar uma subclasse. Então, criamos dois arquivos, um mainwindow.cpp e um mainwindow.h que conterão nosso código.

    mainwindow.h

    #ifndef MAINWINDOW_H
    #define MAINWINDOW_H
     
    #include <KXmlGuiWindow>
    
    class KTextEdit;
     
    class MainWindow : public KXmlGuiWindow
    {
      public:
        explicit MainWindow(QWidget *parent = nullptr);
     
      private:
        KTextEdit* textArea;
    };
     
    #endif
    

    Primeiro derivamos uma subclasse KXmlGuiWindow com class MainWindow : public KXmlGuiWindow e depois declaramos o construtor com MainWindow(QWidget * parent = nullptr); .

    E, finalmente, declaramos um ponteiro para o objeto que vai compor a maior parte do nosso programa. O KTextEdit é um widget genérico de editor de texto rico com alguns detalhes, como ocultar automaticamente o cursor.

    mainwindow.cpp

    #include "mainwindow.h"
    
    #include <KTextEdit>
    
    MainWindow::MainWindow(QWidget *parent) : KXmlGuiWindow(parent)
    {
      textArea = new KTextEdit();
      setCentralWidget(textArea);
      setupGUI();
    }
    

    Primeiramente, é claro, temos que incluir o arquivo de cabeçalho que contém a declaração de classe.

    Inicializamos nosso editor de texto com um objeto e usamos a função interna do KXmlGuiWindow setCentralWidget(), que informa ao KXmlGuiWindow o que deve aparecer na seção central da janela.

    Finalmente, o KXmlGuiWindow::setupGUI() é chamado, o que faz um monte de coisas nos bastidores e cria as barras de menu padrão(Configurações, Ajuda).

    Back to main.cpp

    Para realmente executar esta janela, precisamos adicionar algumas linhas em main.cpp:

    main.cpp

    #include <cstdlib>
    #include <QApplication>
    #include <QCommandLineParser>
    #include <KAboutData>
    #include <KLocalizedString>
    #include "mainwindow.h"
     
    int main (int argc, char *argv[])
    {
        QApplication app(argc, argv);
        KLocalizedString::setApplicationDomain("tutorial2");
        
        KAboutData aboutData(
                             // The program name used internally. (componentName)
                             QStringLiteral("tutorial2"),
                             // A displayable program name string. (displayName)
                             i18n("Tutorial 2"),
                             // The program version string. (version)
                             QStringLiteral("1.0"),
                             // Short description of what the app does. (shortDescription)
                             i18n("A simple text area"),
                             // The license this code is released under
                             KAboutLicense::GPL,
                             // Copyright Statement (copyrightStatement = QString())
                             i18n("(c) 2015"),
                             // Optional text shown in the About box.
                             // Can contain any information desired. (otherText)
                             i18n("Some text..."),
                             // The program homepage string. (homePageAddress = QString())
                             QStringLiteral("http://example.com/"),
                             // The bug report email address
                             // (bugsEmailAddress = QLatin1String("[email protected]")
                             QStringLiteral("[email protected]"));
        aboutData.addAuthor(i18n("Name"), i18n("Task"), QStringLiteral("[email protected]"),
                             QStringLiteral("http://your.website.com"), QStringLiteral("OSC Username"));
        KAboutData::setApplicationData(aboutData);
     
        QCommandLineParser parser;
        aboutData.setupCommandLine(&parser);
        parser.process(app);
        aboutData.processCommandLine(&parser);
        
        MainWindow* window = new MainWindow();
        window->show();
        
        return app.exec();
    }
    

    Novamente, incluímos nosso novo arquivo de cabeçalho para criar nosso objeto MainWindow, que então exibimos.

    CMake

    A melhor maneira de criar o programa é usar o CMake. Nós adicionamos mainwindow.cpp à lista de fontes, incluímos as estruturas XmlGui e TextWidgets (para o KTextEdit) e substituímos todo o texto tutorial1 por tutorial2.

    CMakeLists.txt

    cmake_minimum_required(VERSION 3.0)
    
    project (tutorial2)
    
    set(QT_MIN_VERSION "5.3.0")
    set(KF5_MIN_VERSION "5.2.0")
    
    find_package(ECM 1.0.0 REQUIRED NO_MODULE)
    set(CMAKE_MODULE_PATH ${ECM_MODULE_PATH} ${CMAKE_CURRENT_SOURCE_DIR}/cmake)
    
    include(KDEInstallDirs)
    include(KDECMakeSettings)
    include(KDECompilerSettings NO_POLICY_SCOPE)
    include(FeatureSummary)
    
    find_package(Qt5 ${QT_MIN_VERSION} CONFIG REQUIRED COMPONENTS 
        Core    # QCommandLineParser, QStringLiteral
        Widgets # QApplication 
    )
    
    find_package(KF5 ${KF5_MIN_VERSION} REQUIRED COMPONENTS
        CoreAddons      # KAboutData
        I18n            # KLocalizedString
        XmlGui          # KXmlGuiWindow
        TextWidgets     # KTextEdit
    )
    
    feature_summary(WHAT ALL INCLUDE_QUIET_PACKAGES FATAL_ON_MISSING_REQUIRED_PACKAGES)
        
    set(tutorial2_SRCS main.cpp mainwindow.cpp)
    
    add_executable(tutorial2 ${tutorial2_SRCS})
    
    target_link_libraries(tutorial2
        Qt5::Widgets
        KF5::CoreAddons
        KF5::I18n
        KF5::XmlGui
        KF5::TextWidgets
    )
    
    install(TARGETS tutorial2  ${KDE_INSTALL_TARGETS_DEFAULT_ARGS})
    


    Compilar e executar

    A melhor maneira de compilar, linkar e executar é configurar um ambiente de compilação correto. Mas, para um tutorial simples como este, basta criar um diretório de compilação e compilar a partir daí. Este comando faz tudo isso em uma linha:

    mkdir build && cd build && cmake .. && make && ./tutorial2
    

    Adiante

    Agora você pode seguir para Usando Actions.