diff options
Diffstat (limited to 'tde-i18n-pt/docs/tdewebdev/kommander/dcop.docbook')
| -rw-r--r-- | tde-i18n-pt/docs/tdewebdev/kommander/dcop.docbook | 189 |
1 files changed, 49 insertions, 140 deletions
diff --git a/tde-i18n-pt/docs/tdewebdev/kommander/dcop.docbook b/tde-i18n-pt/docs/tdewebdev/kommander/dcop.docbook index a47d89e800c..d0160d96d80 100644 --- a/tde-i18n-pt/docs/tdewebdev/kommander/dcop.docbook +++ b/tde-i18n-pt/docs/tdewebdev/kommander/dcop.docbook @@ -2,236 +2,145 @@ <sect1 id="dcop-interface"> <sect1info> -<title ->Funções &DCOP;</title> +<title>Funções &DCOP;</title> <authorgroup> -<author -><firstname -></firstname -> <surname -></surname -> <affiliation -><address -> <email -></email> -</address -></affiliation> +<author><firstname></firstname> <surname></surname> <affiliation><address> <email></email> +</address></affiliation> </author> -<othercredit role="translator" -><firstname ->José</firstname -><surname ->Pires</surname -><affiliation -><address -><email ->jncp@netcabo.pt</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> +<othercredit role="translator"><firstname>José</firstname><surname>Pires</surname><affiliation><address><email>jncp@netcabo.pt</email></address></affiliation><contrib>Tradução</contrib></othercredit> </authorgroup> </sect1info> -<title ->Funções &DCOP;</title> +<title>Funções &DCOP;</title> -<para ->O &DCOP; pode ser invocado de várias formas no &kommander;. Primeiro, existe o método da consola </para> -<para ->dcop kmdr-executor-@pid KommanderIf changeWidgetText meuElemento <quote ->novo texto</quote -> </para> -<para ->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 <quote ->kmdr-executor-@pid</quote -> 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;. </para> -<para ->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: </para> -<para ->@dcop(@dcopid, KommanderIf, <quote ->enableWidget(QString, bool)</quote ->, Widget, true) </para> -<para ->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 <application ->bash</application ->) significa que você precisa de usar chamadas dos métodos a partir da consola. <emphasis ->Se usar o &DCOP; interno, todos os especiais do &kommander; serão executados primeiro e depois o programa será então executado.</emphasis -> </para> -<para ->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. </para> -<para ->@CampoTexto1.changeWidgetText(Novo texto) </para> -<para ->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. <emphasis ->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.</emphasis -> </para> +<para>O &DCOP; pode ser invocado de várias formas no &kommander;. Primeiro, existe o método da consola </para> +<para>dcop kmdr-executor-@pid KommanderIf changeWidgetText meuElemento <quote>novo texto</quote> </para> +<para>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 <quote>kmdr-executor-@pid</quote> 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;. </para> +<para>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: </para> +<para>@dcop(@dcopid, KommanderIf, <quote>enableWidget(QString, bool)</quote>, Widget, true) </para> +<para>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 <application>bash</application>) significa que você precisa de usar chamadas dos métodos a partir da consola. <emphasis>Se usar o &DCOP; interno, todos os especiais do &kommander; serão executados primeiro e depois o programa será então executado.</emphasis> </para> +<para>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. </para> +<para>@CampoTexto1.changeWidgetText(Novo texto) </para> +<para>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. <emphasis>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.</emphasis> </para> <sect2 id="dcop-globals"> -<title ->O &DCOP; para Variáveis Globais</title> +<title>O &DCOP; para Variáveis Globais</title> <variablelist> <varlistentry> -<term ->global(QString nomeVariavel)</term> +<term>global(QString nomeVariavel)</term> <listitem> -<para ->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 <quote ->âmbito</quote -> 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 <function ->@setGlobal</function ->. </para> +<para>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 <quote>âmbito</quote> 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 <function>@setGlobal</function>. </para> </listitem> </varlistentry> <varlistentry> -<term ->setGlobal(QString nomeVariavel, QString valor)</term> +<term>setGlobal(QString nomeVariavel, QString valor)</term> <listitem> -<para ->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. </para> +<para>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. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="dcop-all"> -<title ->O &DCOP; para Todos os Elementos</title> +<title>O &DCOP; para Todos os Elementos</title> <variablelist> <varlistentry> -<term ->changeWidgetText(QString texto)</term> +<term>changeWidgetText(QString texto)</term> <listitem> -<para ->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. </para> +<para>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. </para> </listitem> </varlistentry> <varlistentry> -<term ->enableWidget(bool activar)</term> +<term>enableWidget(bool activar)</term> <listitem> -<para ->Activa ou desactiva um dado elemento gráfico. </para> +<para>Activa ou desactiva um dado elemento gráfico. </para> </listitem> </varlistentry> <varlistentry> -<term ->associatedText</term> +<term>associatedText</term> <listitem> -<para ->Devolve o texto associado com o elemento gráfico indicado. Este não é o mesmo que o texto apresentado. Será o <quote ->@widgetText</quote -> ou o texto e/ou programa usado para chegar ao valor apresentado. </para> +<para>Devolve o texto associado com o elemento gráfico indicado. Este não é o mesmo que o texto apresentado. Será o <quote>@widgetText</quote> ou o texto e/ou programa usado para chegar ao valor apresentado. </para> </listitem> </varlistentry> <varlistentry> -<term ->setAssociatedText(QString texto)</term> +<term>setAssociatedText(QString texto)</term> <listitem> -<para ->Isto configura o texto por omissão do Texto do &kommander;. Isto é tipicamente igual a <quote ->@widgetText</quote -> 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. </para> +<para>Isto configura o texto por omissão do Texto do &kommander;. Isto é tipicamente igual a <quote>@widgetText</quote> 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. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="dcop-box"> -<title ->O &DCOP; para os Elementos ListBox e ComboBox</title> +<title>O &DCOP; para os Elementos ListBox e ComboBox</title> <variablelist> <varlistentry> -<term ->addListItem(QString item, int indice)</term> +<term>addListItem(QString item, int indice)</term> <listitem> -<para ->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. </para> +<para>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. </para> </listitem> </varlistentry> <varlistentry> -<term ->addListItems(QStringList itens, int indice)</term> +<term>addListItems(QStringList itens, int indice)</term> <listitem> -<para ->Isto adiciona uma lista de cadeias de caracteres logo de uma vez. A lista deverá delimitada por caracteres <acronym ->EOL</acronym -> (\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. </para> +<para>Isto adiciona uma lista de cadeias de caracteres logo de uma vez. A lista deverá delimitada por caracteres <acronym>EOL</acronym> (\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. </para> </listitem> </varlistentry> <varlistentry> -<term ->addUniqueItem(QString item)</term> +<term>addUniqueItem(QString item)</term> <listitem> -<para ->O 'addUniqueItem' irá adicionar um item ao fim da lista, somente se for único. </para> +<para>O 'addUniqueItem' irá adicionar um item ao fim da lista, somente se for único. </para> </listitem> </varlistentry> <varlistentry> -<term ->clearList</term> +<term>clearList</term> <listitem> -<para ->Remove todos os itens. </para> +<para>Remove todos os itens. </para> </listitem> </varlistentry> <varlistentry> -<term ->removeListItem(int indice)</term> +<term>removeListItem(int indice)</term> <listitem> -<para ->Remove o item no índice indicado. </para> +<para>Remove o item no índice indicado. </para> </listitem> </varlistentry> <varlistentry> -<term ->item(int indice)</term> +<term>item(int indice)</term> <listitem> -<para ->Devolve o texto do item no índice indicado. </para> +<para>Devolve o texto do item no índice indicado. </para> </listitem> </varlistentry> <varlistentry> -<term ->setCurrentListItem(int indice)</term> +<term>setCurrentListItem(int indice)</term> <listitem> -<para ->Configura o item actual (ou seleccionado) com o índice indicado. Aplica-se aos elementos ListBox e ComboBox. </para> +<para>Configura o item actual (ou seleccionado) com o índice indicado. Aplica-se aos elementos ListBox e ComboBox. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="dcop-button"> -<title ->O &DCOP; para os Elementos CheckBox e RadioButton</title> +<title>O &DCOP; para os Elementos CheckBox e RadioButton</title> <variablelist> <varlistentry> -<term ->setChecked(QString nomeElemento, bool assinalado)</term> +<term>setChecked(QString nomeElemento, bool assinalado)</term> <listitem> -<para ->Liga/desliga os elementos CheckBox ou RadioButton. </para> +<para>Liga/desliga os elementos CheckBox ou RadioButton. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="dcop-tab"> -<title ->O &DCOP; para os Elementos TabWidget</title> +<title>O &DCOP; para os Elementos TabWidget</title> <variablelist> <varlistentry> -<term ->setCurrentTab(QString nomeElemento, int indice)</term> +<term>setCurrentTab(QString nomeElemento, int indice)</term> <listitem> -<para ->Selecciona a página pelo índice nos TabWidgets. O índice começa em 0 (zero). </para> +<para>Selecciona a página pelo índice nos TabWidgets. O índice começa em 0 (zero). </para> </listitem> </varlistentry> </variablelist> |