From 9b58d35185905f8334142bf4988cb784e993aea7 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Mon, 21 Nov 2011 02:23:03 -0600 Subject: Initial import of extracted KDE i18n tarballs --- tde-i18n-pt/docs/kdewebdev/kommander/dcop.docbook | 241 ++++++++++++++++++++++ 1 file changed, 241 insertions(+) create mode 100644 tde-i18n-pt/docs/kdewebdev/kommander/dcop.docbook (limited to 'tde-i18n-pt/docs/kdewebdev/kommander/dcop.docbook') diff --git a/tde-i18n-pt/docs/kdewebdev/kommander/dcop.docbook b/tde-i18n-pt/docs/kdewebdev/kommander/dcop.docbook new file mode 100644 index 00000000000..a47d89e800c --- /dev/null +++ b/tde-i18n-pt/docs/kdewebdev/kommander/dcop.docbook @@ -0,0 +1,241 @@ + + + + +Funções &DCOP; + +
+
 + + +JoséPires
jncp@netcabo.pt
Tradução + + + + +Funções &DCOP; + +O &DCOP; pode ser invocado de várias formas no &kommander;. Primeiro, existe o método da consola +dcop kmdr-executor-@pid KommanderIf changeWidgetText meuElemento novo texto +Isto assume que você está dentro de um ficheiro do &kommander; e que tem acesso ao especial @pid, o qual contém o ID do processo. De facto, é mais simples substituir o kmdr-executor-@pid por @dcopid. Contudo, você poderá usar esta sintaxe (obviamente sem os especiais) a partir da linha de comandos ou com algum programa externo para alterar a janela do &kommander;. +Dado que o &kommander; não tem um processador completo na sua fase 'Alpha', se você quiser usar o &DCOP; interno, que é muito mais rápido, a partir de outra janela da aplicação (o &DCOP; da consola é bastante lento), será mais complicado porque você precisa de dar bastantes informações, incluindo um protótipo da chamada. A chamada acima ficaria igual a: +@dcop(@dcopid, KommanderIf, enableWidget(QString, bool), Widget, true) +Na altura em que isto foi escrito, você deverá saber que o encadeamento de chamadas de &DCOP; dentro de estruturas da linguagem de programação (como o bash) significa que você precisa de usar chamadas dos métodos a partir da consola. Se usar o &DCOP; interno, todos os especiais do &kommander; serão executados primeiro e depois o programa será então executado. +Existe uma nova forma simplificada de usar o &DCOP; dentro do &kommander;, através de uma sintaxe de objectos. Digamos que você deseje alterar o texto num elemento chamado @CampoTexto1. Seria algo semelhante ao seguinte. +@CampoTexto1.changeWidgetText(Novo texto) +Como poderá ver, a nova sintaxe é muito simples, assim como é consistente visualmente com os grupos de funções. Todas as referências ao &DCOP; irão usar a nova sintaxe de objectos indicada acima. Lembre-se por favor que, se for referenciar um elemento gráfico a partir do &DCOP; noutra janela ou com outra aplicação, o primeiro parâmetro será sempre o nome do elemento gráfico. Todas as funções são listadas aqui a começar pelo segundo parâmetro. + + +O &DCOP; para Variáveis Globais + + +global(QString nomeVariavel) + +Devolve o valor da variável global indicada. Quando um programa é corrido dentro de uma janela do &kommander;, todas as variáveis (não-globais) definidas neste programa deixarão de existir depois de o programa terminar e, como tal, não estarão disponíveis para outros processos de programas ou numa nova instância do processo que invoca. O âmbito global significa que a variável irá existir para qualquer processo da janela até que esta seja fechada. Você poderá alterar estas variáveis em qualquer altura com uma chamada nova ao @setGlobal. + + + +setGlobal(QString nomeVariavel, QString valor) + +Cria uma variável que é global para o processo da janela e atribui o valor a ela. Este valor poderá ser obtido com a chamada global(QString nomeVariavel) ou alterada de novo. + + + + + + +O &DCOP; para Todos os Elementos + + + +changeWidgetText(QString texto) + +Este deverá ser mudado para 'setWidgetText' e este nome poderá vir a ficar obsoleto. Isto remove o texto apresentado no elemento gráfico e substitui-o pelo texto indicado. + + + +enableWidget(bool activar) + +Activa ou desactiva um dado elemento gráfico. + + + +associatedText + +Devolve o texto associado com o elemento gráfico indicado. Este não é o mesmo que o texto apresentado. Será o @widgetText ou o texto e/ou programa usado para chegar ao valor apresentado. + + + +setAssociatedText(QString texto) + +Isto configura o texto por omissão do Texto do &kommander;. Isto é tipicamente igual a @widgetText para mostrar o que é introduzido no elemento gráfico. É pouco provável que tenha muita necessidade disto, mas se o fizer, será aqui. Aplica-se a todos os elementos que possam conter dados. + + + + + + +O &DCOP; para os Elementos ListBox e ComboBox + + +addListItem(QString item, int indice) + +Adiciona um item a um elemento ListBox no índice indicado. O índice da lista começa em zero. Para adicionar ao fim da lista, use -1. + + + +addListItems(QStringList itens, int indice) + +Isto adiciona uma lista de cadeias de caracteres logo de uma vez. A lista deverá delimitada por caracteres EOL (\n - mudança de linha). Isto é útil, dado que poderá usar a 'bash' para derivar a lista de forma relativamente simples. Por exemplo, se usar @exec(ls -l ~/projectos | grep kmdr) para os itens, irá ter uma listagem dos ficheiros do &kommander; na sua pasta de projectos. O índice da lista começa em zero. Use o -1 para adicionar ao fim da lista. + + + +addUniqueItem(QString item) + +O 'addUniqueItem' irá adicionar um item ao fim da lista, somente se for único. + + + +clearList + +Remove todos os itens. + + + +removeListItem(int indice) + +Remove o item no índice indicado. + + + +item(int indice) + +Devolve o texto do item no índice indicado. + + + +setCurrentListItem(int indice) + +Configura o item actual (ou seleccionado) com o índice indicado. Aplica-se aos elementos ListBox e ComboBox. + + + + + + +O &DCOP; para os Elementos CheckBox e RadioButton + + +setChecked(QString nomeElemento, bool assinalado) + +Liga/desliga os elementos CheckBox ou RadioButton. + + + + + + +O &DCOP; para os Elementos TabWidget + + +setCurrentTab(QString nomeElemento, int indice) + +Selecciona a página pelo índice nos TabWidgets. O índice começa em 0 (zero). + + + + + + + -- cgit v1.2.3