Revision as of 20:10, 28 October 2019 by Juliano Assis (talk | contribs) (Created page with "Ou você pode aprender omo colocar seu aplicativo no K-Menu usando arquivos .desktop.")
8 arquivo appnameui.rc
9.2 Compilar, Instalar e Executar
10 Adiante
A função setupGUI() em KXmlGuiWindow depende do sistema XMLGUI para construir a GUI, no qual o XMLGUI faz analizando uma descrição de arquivo XML da interface.
A regra para nomear esse arquivo XML é appnameui.rc, onde appname é o nome que você definiu em KAboutData} KAboutData (neste caso, tutorial3). Portanto, em nosso exemplo, o arquivo é chamado tutorial3ui.rc e está localizado no diretório de build. O local onde o arquivo será finalmente colocado é tratado pelo CMake.
arquivo appnameui.rc
Como a descrição da interface do usuário é definida com XML, o layout deve seguir regras estritas. Este tutorial não entrará em detalhes sobre este tópico, mas para obter mais informações, consulte a página detalhada do XMLGUI.
A tag <Toolbar> permite que você descreva a barra de ferramentas, que é a barra na parte superior da janela, normalmente com ícones. Aqui é dado o nome exclusivo mainToolBar e seu nome visível ao usuário definido como Main Toolbar usando a tag <text>. A action clear é adicionada à barra de ferramentas usando a tag <Action>, o parâmetro name nessa tag é a string que foi passada para o KActionCollection com addAction() em mainwindow.cpp.
Além de ter o action na barra de ferramentas, também pode ser adicionado à barra de menus. Aqui a ação está sendo adicionada ao menu File do MenuBar da mesma maneira que foi adicionada à barra de ferramentas.
Altere o atributo 'version' da tag <gui> se você alterou o arquivo .rc desde a última instalação para forçar uma atualização do cache do sistema. Certifique-se de que é um número inteiro, se você usar um valor decimal ele não funcionará, e não notificará . "
O atributo version deve sempre ser um número inteiro.
Algumas notas sobre a interação entre o código e o arquivo .rc: Os menus aparecem automaticamente e devem ter uma tag filha <text/> , a menos que se refiram aos menus padrão. Actions precisam ser criados manualmente e inseridos no actionCollection () usando o nome no arquivo .rc. Actions podem ser ocultados ou desabilitados, enquanto os menus não.
Finalmente, o tutorial3ui.rc precisa ir a algum lugar onde o KDE possa encontrá-lo (não pode simplesmente deixá-lo no diretório de origem!). Isso significa que o projeto precisa ser instalado em algum lugar, diferente dos tutoriais anteriores.
Esse arquivo é quase idêntico ao do tutorial2, mas com duas linhas extras no final que descrevem onde os arquivos devem ser instalados. Primeiramente, o destino do tutorial3 é instalado no KDE_INSTALL_TARGETS_DEFAULT_ARGS e, em seguida, o arquivo tutorial3ui.rc que descreve o layout da interface do usuário é instalado no diretório de dados do aplicativo em KDE_INSTALL_KXMLGUI5DIR.
Compilar, Instalar e Executar
Esta é provavelmente a parte mais complicada. Onde você instala os arquivos, especialmente o tutorial3ui.rc é importante. Normalmente, você deseja instalá-lo onde o KDE software é instalado pela sua distribuição, que geralmente está em /usr. Isso, no entanto, exigiria acesso root/admin e, se você não tiver, poderá instalá-lo em uma pasta no seu diretório home.
Para informar ao CMake onde instalar o programa, defina a opção DCMAKE_INSTALL_PREFIX. Você provavelmente só quer instalá-lo em algum local local para teste (provavelmente é um pouco tolo tentar instalar esses tutoriais no diretório do KDE); portanto, o seguinte pode ser apropriado:
que criará uma estrutura de diretório semelhante ao KDE no diretório home do usuário. Especificamente, ele criará os diretórios $HOME/bin/ e $HOME/share/ e instalará o executável em $HOME/bin/tutorial3 e o arquivo tutorial3ui.rc em $HOME/share/kxmlgui/tutorial3/tutorial3ui.rc.
No entanto, para executar o programa corretamente, você deverá informar o sistema onde está o arquivo XMLGUI. Como o instalamos em um local fora do padrão, precisaremos sempre apontar explicitamente. O seguinte comando seria suficiente:
Isso adiciona(anexa) temporariamente o local do "share" recém-criado a XDG_DATA_DIRS, o caminho padrão para os arquivos de dados do aplicativo.
Agora você pode seguir para salvando e carregando.
Ou você pode aprender como adicionar ícones ao seu aplicativo.
Ou você pode aprender omo colocar seu aplicativo no K-Menu usando arquivos .desktop.
Retrieved from "https://techbase.kde.org/index.php?title=Development/Tutorials/Using_Actions/pt-br&oldid=105447"