diff options
Diffstat (limited to 'tde-i18n-pt_BR/docs/kdebase/kate/advanced.docbook')
| -rw-r--r-- | tde-i18n-pt_BR/docs/kdebase/kate/advanced.docbook | 2324 |
1 files changed, 0 insertions, 2324 deletions
diff --git a/tde-i18n-pt_BR/docs/kdebase/kate/advanced.docbook b/tde-i18n-pt_BR/docs/kdebase/kate/advanced.docbook deleted file mode 100644 index 68562d81bc6..00000000000 --- a/tde-i18n-pt_BR/docs/kdebase/kate/advanced.docbook +++ /dev/null @@ -1,2324 +0,0 @@ -<chapter id="advanced-editing-tools"> -<chapterinfo> -<authorgroup> -<author ->&Anders.Lund; &Anders.Lund.mail;</author> -<author ->&Dominik.Haumann; &Dominik.Haumann.mail;</author> -<othercredit role="translator" -><firstname ->Lisiane</firstname -><surname ->Sztoltz</surname -><affiliation -><address -><email ->[email protected]</email -></address -></affiliation -><contrib ->Tradução</contrib -></othercredit -> -</authorgroup> -</chapterinfo> -<title ->Ferramentas Avançadas de Edição</title> - -<sect1 id="advanced-editing-tools-comment"> - -<title ->Comentar/Descomentar</title> - -<para ->Os comandos Comentar e Descomentar, disponíveis no menu <guimenu ->Ferramentas</guimenu -> permitem-lhe adicionar ou remover marcações de comentários à seleção ou à linha atual, se não existir texto selecionado, se os comentários são suportados pelo formato do texto que você está editando.</para> - -<para ->As regras de como o comentário é feito são feitas nas definições de sintaxe; assim, se o realce de sintaxe não é usado, as ações de comentar/descomentar não são possíveis. </para> - -<para ->Alguns formatos definem marcas de comentários para linhas únicas, outros suportam marcas de comentários para várias linhas e alguns suportam ambas. Se não estiverem disponíveis os comentários para várias linhas, o ato de comentar uma seleção que não inclui por completo a sua última linha não é possível.</para> - -<para ->Se um marcador de linha única estiver disponível, é preferível comentar linhas simples onde for aplicável, pois isto ajuda a evitar problemas com comentários aninhados.</para> - -<para ->Ao remover marcadores de comentários, textos sem comentários devem ser selecionados; ao remover marcadores de comentários de múltiplas linhas de uma seleção, qualquer espaço em branco fora do marcador é ignorado.</para> - -<para -><indexterm -><primary ->comentar</primary -></indexterm -> Para colocar marcações de comentários, use a opção do menu <menuchoice -><guimenu ->Ferramentas</guimenu -><guimenuitem ->Comentar</guimenuitem -></menuchoice -> ou o atalho de teclado relacionado, que por padrão é <keycombo action="simul" ->&Ctrl;<keycap ->D</keycap -></keycombo ->.</para> - -<para -><indexterm -><primary ->descomentar</primary -></indexterm -> Para remover marcações de comentários, use a opção do menu <menuchoice -><guimenu ->Ferramentas</guimenu -><guimenuitem ->Descomentar</guimenuitem -></menuchoice -> ou o atalho de teclado relacionado, que por padrão é o <keycombo action="simul" ->&Ctrl;&Shift;<keycap ->D</keycap -></keycombo ->.</para> - -</sect1> - -<sect1 id="advanced-editing-tools-commandline"> -<title ->A Linha de Comando do Componente de Edição</title> - -<para ->O componente de edição do Kate possui uma linha de comando interna, que lhe permite efetuar várias ações a partir de uma interface mínima. A linha de comando é um campo de texto no fundo da área de edição onde, para mostrá-la, você poderá selecionar a opção <menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Alternar para Linha de Comando</guimenuitem -></menuchoice -> ou usar o atalho (que é, por padrão, o <keycombo action="simul" -><keycap ->F7</keycap -></keycombo ->). O editor oferece um conjunto de comandos, tal como está documentado abaixo, sendo oferecidos mais comandos através de 'plugins'.</para> - -<para ->Para executar um comando, pressione a tecla Return. A linha de comando irá indicar se foi bem sucedida e, provavelmente, irá mostrar uma mensagem. Se você inseriu na linha de comando pressionando <keycap ->F7</keycap ->, ele ocultar-se-á automaticamente, ao fim de alguns segundos. Para limpar a mensagem e inserir um comando novo, pressione <keycap ->F7</keycap -> de novo.</para> - -<para ->A linha de comando possui um sistema de ajuda embutido, podendo inserir o comando <command ->help</command -> para iniciá-lo. Para ver uma lista com todos os comandos disponíveis, invoque o comando <command ->help list</command ->; para ver a ajuda sobre um determinado comando, faça <command ->help <replaceable ->comando</replaceable -></command ->.</para> - -<para ->A linha de comando possui um histórico embutido, como tal, o usuário poderá reutilizar os comandos já digitados. Para navegar no histórico, use as teclas <keycap ->Cima</keycap -> e <keycap ->Baixo</keycap ->. Ao mostrar os comandos do histórico, a parte do argumento do comando será selecionada, o que lhe permite sobrepor facilmente os argumentos.</para> - -<sect2 id="advanced-editing-tools-commandline-commands"> -<title ->Comandos Padrão da Linha de Comando</title> - -<sect3 id="advanced-editing-tools-commandline-commands-configure"> -<title ->Comandos para Configurar o Editor</title> - -<para ->Estes comandos são oferecidos pelo componente do editor e permitem-lhe configurar apenas o documento e a janela ativos. Isto poderá ser útil se quiser usar uma configuração diferente da pré-definida como, por exemplo, na indentação. </para> - -<variablelist> -<title ->Tipos de argumento</title> - -<varlistentry> -<term ->BOOLEANO</term> -<listitem -><para ->Isto é usado com os comandos que ativam ou desativam certas coisa. Os valores válidos são o <userinput ->on</userinput ->, <userinput ->off</userinput ->, <userinput ->true</userinput ->, <userinput ->false</userinput ->, <userinput ->1</userinput -> ou <userinput ->0</userinput -></para -></listitem> -</varlistentry> - -<varlistentry> -<term ->INTEIRO</term> -<listitem -><para ->Um número inteiro</para -></listitem> -</varlistentry> - -<varlistentry> -<term ->TEXTO</term> -<listitem -><para ->Um texto</para -></listitem> -</varlistentry> - -</variablelist> - -<variablelist> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-tab-width</command -><arg ->INTEIRO largura</arg -></cmdsynopsis -></term> -<listitem -><para ->Configura a largura da tabulação como sendo <userinput ->largura</userinput -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-indent-width</command -><arg ->INTEIRO largura</arg -></cmdsynopsis -></term> -<listitem -><para ->Configura a largura da indentação como <userinput ->largura</userinput ->. Só é usado se o usuário indentar com espaços.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-word-wrap-column</command -><arg ->INTEIRO largura</arg -></cmdsynopsis -></term> -<listitem -><para ->Configura a largura da linha para uma quebra como tendo <userinput ->largura</userinput -> colunas. Isto é usado se você tiver o seu texto sendo quebrado automaticamente.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-icon-border</command -><arg ->BOOLEANO ativar</arg -> </cmdsynopsis -></term> -<listitem -><para ->Configura a visibilidade da borda dos ícones.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-folding-markers</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Configura a visibilidade da área de marcadores de dobra do código.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-line-numbers</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Configura a visibilidade da área de números de linha.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-replace-tabs</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Se estiver ativo, as tabulações são substituídas por espaços, à medida que você vai digitando. </para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-remove-trailing-space</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Se estiver ativo, os espaços finais serão removidos quando o cursor abandonar uma determinada linha.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-show-tabs</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Se estiver ativo, os caracteres de tabulação e espaços estarão visíveis através de um pequeno ponto.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-indent-spaces</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Se estiver ativo, o editor irá indentar com <option ->largura-indentação</option -> espaços por cada nível de indentação, em vez de usar o caracter TAB.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-mixed-indent</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Se estiver ativo, o &kate; irá usar uma mistura de TABs e espaços para a indentação. Cada nível de indentação irá ter um tamanho de <option ->largura-indentação</option ->, enquanto os restantes níveis de indentação serão otimizados para usar tantos caracteres TAB quantos possíveis.</para> -<para ->Quando for executado, este comando irá ativar a indentação com espaços e, se a largura de indentação não estiver definida, corresponderá a metade da <option ->largura-tabulação</option -> do documento, no momento da execução.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-word-wrap</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Ativa a quebra de linha dinâmica, de acordo com o parâmetro <userinput ->ativar</userinput -></para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-replace-tabs-save</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Quando estiver ativo, as tabulações serão substituídas por espaços em branco, sempre que o documento for salvo.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-remove-trailing-space-save</command -><arg ->BOOLEANO ativar</arg -></cmdsynopsis -></term> -<listitem -><para ->Quando estiver ativo, os espaços finais serão removidos de cada linha, sempre que o documento for salvo.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-indent-mode</command -><arg ->nome</arg -></cmdsynopsis -></term> -<listitem -><para ->Configura o modo de indentação automática como <userinput ->nome</userinput ->. Se o <userinput ->nome</userinput -> não for conhecido, o modo é configurado como 'none' (nenhum). Os modos válidos são o 'cstyle', 'csands', 'xml', 'python', 'varindent' e 'none'.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->set-highlight</command -><arg ->realce</arg -></cmdsynopsis -></term> -<listitem -><para ->Configura o sistema de realce de sintaxe para o documento. O argumento deverá ser um nome de realce válido, como pode ser visto no menu <menuchoice -><guimenu ->Ferramentas</guimenu -><guisubmenu ->Realce</guisubmenu -></menuchoice ->. Este comando oferece uma lista de completação automática para o seu argumento.</para -></listitem> -</varlistentry> - -</variablelist> - -</sect3> - -<sect3 id="advanced-editing-tools-commandline-commands-edit"> -<title ->Comandos de edição</title> - -<para ->Estes comandos modificam o documento atual.</para> - -<variablelist> -<varlistentry> -<term -><cmdsynopsis -><command ->indent</command -></cmdsynopsis -></term> -<listitem -><para ->Indenta as linhas selecionadas ou a linha atual.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->unindent</command -></cmdsynopsis -></term> -<listitem -><para ->Remove um nível de indentação das linhas selecionadas ou da linha atual.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->cleanindent</command -></cmdsynopsis -></term> -<listitem -><para ->Limpa a indentação das linhas selecionadas ou da linha atual, de acordo com a configuração de indentação no documento. </para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->comment</command -></cmdsynopsis -></term> -<listitem -><para ->Insere marcações de comentários para fazer da seleção, linhas selecionadas ou da linha atual um comentário, de acordo com o formato de texto definido pela definição do realce de sintaxe para o documento.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->uncomment</command -></cmdsynopsis -></term> -<listitem -><para ->Remove os marcadores de comentários da seleção, linhas selecionadas ou da linha atual, de acordo com o formato de texto definido pela definição do realce de sintaxe do documento.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->kill-line</command -></cmdsynopsis -></term> -<listitem -><para ->Remove a linha atual.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->replace</command -><arg ->padrão</arg -><arg ->substituição</arg -></cmdsynopsis -></term> -<listitem -><para ->Substitui o texto correspondente ao <userinput ->padrão</userinput -> por <userinput ->substituição</userinput ->. Se você quiser incluir espaços em branco no <userinput ->padrão</userinput ->, deverá colocar tanto o <userinput ->padrão</userinput -> como a <userinput ->substituição</userinput -> entre aspas simples ou duplas. Se os argumentos não estiverem entre estes caracteres, a primeira palavra é usada como <userinput ->padrão</userinput -> e o resto como a <userinput ->substituição</userinput ->. Se a <userinput ->substituição</userinput -> estiver em branco, cada ocorrência do <userinput ->padrão</userinput -> será removida.</para> -<para ->Você poderá configurar opções para modificar a procura, adicionando dois pontos (:), seguidos de uma ou mais letras, onde cada uma representa uma configuração, o que corresponderá ao formato <userinput ->replace:opções padrão substituição</userinput ->. As opções disponíveis são: <variablelist> - -<varlistentry> -<term -><userinput ->b</userinput -></term> -<listitem -><para ->Procura para trás.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->c</userinput -></term> -<listitem -><para ->Procura a partir da posição do cursor.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->e</userinput -></term> -<listitem -><para ->Procura apenas na área selecionada.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->r</userinput -></term> -<listitem -><para ->Faz uma pesquisa por uma determinada expressão regular. Se estiver ativo, você poderá usar o <userinput ->\N</userinput ->, onde o N é um número que representa as capturas no texto de substituição.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->s</userinput -></term> -<listitem -><para ->Faz uma pesquisa com distinção entre maiúsculas e minúsculas.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->p</userinput -></term> -<listitem -><para ->Pede permissão para substituir a próxima ocorrência.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->w</userinput -></term> -<listitem -><para ->Faz uma correspondência apenas com palavras inteiras.</para -></listitem> -</varlistentry> - -</variablelist> - -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->date</command -><arg ->formato</arg -></cmdsynopsis -></term> -<listitem -><para ->Insere um texto de data/hora, tal como está definido pelo <userinput ->formato</userinput -> indicado, ou com o formato <quote ->aaaa-MM-dd hh:mm:ss</quote ->, se não for indicada qualquer formatação. As traduções a seguir são feitas quando for interpretado o <userinput ->formato</userinput ->: <informaltable -> <tgroup cols="2" -> <tbody> -<row -><entry -><literal ->d</literal -></entry -><entry ->O dia, como um número sem um zero inicial (1-31).</entry -></row> -<row -><entry -><literal ->dd</literal -></entry -><entry ->O dia, como um número com um zero inicial (01-31).</entry -></row> -<row -><entry -><literal ->ddd</literal -></entry -><entry ->O nome do dia abreviado, no formato regional (p.ex. 'Seg'..'Dom').</entry -></row> -<row -><entry -><literal ->dddd</literal -></entry -><entry ->O nome do dia completo, no formato regional (p.ex. 'Segunda'..'Domingo').</entry -></row> -<row -><entry -><literal ->M</literal -></entry -><entry ->O mês, como um número sem um zero inicial (1-12).</entry -></row> -<row -><entry -><literal ->MM</literal -></entry -><entry ->O mês, como um número com um zero inicial (01-12).</entry -></row> -<row -><entry -><literal ->MMM</literal -></entry -><entry ->O nome do mês abreviado, no formato regional (p.ex. 'Jan'..'Dez').</entry -></row> -<row -><entry -><literal ->aa</literal -></entry -><entry ->O ano, como um número de dois algarismos (00-99).</entry -></row> -<row -><entry -><literal ->aaaa</literal -></entry -><entry ->O ano, como um número de quatro algarismos (1752-8000).</entry -></row> -<row -><entry -><literal ->h</literal -></entry -><entry ->As horas sem um zero inicial (0..23 ou 1..12 no caso do formato AM/PM).</entry -></row> -<row -><entry -><literal ->hh</literal -></entry -><entry ->As horas com um zero inicial (00..23 ou 01..12 no caso do formato AM/PM).</entry -></row> -<row -><entry -><literal ->m</literal -></entry -><entry ->Os minutos sem um zero inicial (0..59).</entry -></row> -<row -><entry -><literal ->mm</literal -></entry -><entry ->Os minutos com um zero inicial (00..59).</entry -></row> -<row -><entry -><literal ->s</literal -></entry -><entry ->Os segundos sem um zero inicial (0..59).</entry -></row> -<row -><entry -><literal ->ss</literal -></entry -><entry ->Os minutos com um zero inicial (00..59).</entry -></row> -<row -><entry -><literal ->z</literal -></entry -><entry ->Os milisegundos sem um zero inicial (0..999).</entry -></row> -<row -><entry -><literal ->zzz</literal -></entry -><entry ->Os milisegundos com zeros iniciais (000..999).</entry -></row> -<row -><entry -><literal ->AP</literal -></entry -><entry ->Usar o formato de horas AM/PM. O AP será substituído por "AM" ou por "PM".</entry -></row> -<row -><entry -><literal ->ap</literal -></entry -><entry ->Usar o formato de horas am/pm. O ap será substituído por "am" ou por "pm".</entry -></row> - -</tbody> -</tgroup> -</informaltable> - -</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->char</command -><arg ->identificador</arg -></cmdsynopsis -></term> -<listitem> -<para ->Este comando permite que você insira caracteres literais através de suas identificações numéricas, em decimal, octal ou hexadecimal. Para usá-lo, abra o diálogo de Edição de Comando e digite <userinput ->char: [número]</userinput -> na caixa de entrada e clique em <guibutton ->OK</guibutton ->.</para> - -<example> -<title ->exemplos do comando <command ->char</command -></title> - -<para ->Entrada: <userinput ->char:234</userinput -></para> -<para ->Resultado: <computeroutput ->ê</computeroutput -></para> -<para ->Entrada: <userinput ->char:0x1234</userinput -></para> -<para ->Resultado: <computeroutput ->ሴ</computeroutput -></para> -</example> - -</listitem> -</varlistentry> - -<varlistentry> -<term> -<indexterm -><primary ->substituir no estilo sed</primary> -<secondary ->procurar no estilo sed</secondary -></indexterm> -<command ->s///[ig]</command -> <command ->%s///[ig]</command -></term> - -<listitem> -<para ->Este comando faz um sed como operação de procura/substituição na linha atual, ou em um arquivo inteiro (<command ->%s///</command ->).</para> - -<para ->Em resumo, é procurado o texto que combine com o <emphasis ->padrão de busca </emphasis ->, a expressão regular entre a primeira e a segunda barra, e quando é encontrado, a parte que combina com o texto é substituída pela expressão entre a metade e a última parte da string. Os parênteses no padrão de busca criam <emphasis ->referências anteriores</emphasis ->, isto é, o comando lembra qual parte procurada combinou no parênteses; estas strings podem ser reutilizadas no padrão de substituição, referidas como <userinput ->\1</userinput -> para o primeiro conjunto de parênteses, <userinput ->\2</userinput -> para o segundo e assim por diante.</para> - -<para ->Para procurar por um caractere literal <literal ->(</literal -> ou <literal ->)</literal ->, você precisa usar o caractere de <emphasis ->escape</emphasis ->, que é o caractere de barra invertida: <userinput ->\(\)</userinput -></para> - -<para ->Se você puser um <userinput ->i</userinput -> no fim da expressão, a correspondência não fará distinção entre maiúsculas ou minúsculas. Se, por outro lado, puser um <userinput ->g</userinput -> no fim, todas as ocorrências do padrão serão substituídas, caso contrário, só será substituída a primeira ocorrência.</para> - -<example> - -<title ->Substituindo texto na linha atual</title> - -<para ->Seu compilador parou, dizendo a você que a classe <classname -> minhaClasse</classname ->, mencionada na linha 3902 do seu arquivo fonte, não está definida.</para> - -<para ->"Droga!" você pensa, é claro que é <classname ->MinhaClasse</classname ->. Você vai para a linha 3902, e em vez de tentar encontrar a palavra no texto, você lança o Diálogo de Edição de Comando, digita <userinput ->s/minhaclasse/MinhaClasse/i</userinput ->, clica no botão <guibutton ->OK</guibutton ->, salva o arquivo e compila – com sucesso, sem erros.</para> - -</example> - -<example> -<title ->Substituindo texto no arquivo inteiro</title> - -<para ->Imagine que você tem um arquivo, onde está mencionado a string <quote ->Senhorita Jensen</quote -> várias vezes, quando alguém vem e lhe diz que ela casou com o <quote ->Senhor Jones</quote ->. Você quer, é claro, substituir toda ocorrência de <quote ->Senhorita Jensen</quote -> por <quote ->Senhora Jones</quote ->.</para> - -<para ->Entre na linha de comando e digite o comando <userinput ->%s/Srª Silva/Srª Braga/</userinput ->, pressionando RETURN para terminar.</para> - -</example> - -<example> -<title ->Um Exemplo Mais Avançado</title> - -<para ->Este exemplo tira partido das <emphasis ->referências anteriores</emphasis -> assim como das <emphasis ->classes de palavras</emphasis -> (se você não souber o que isso é, baseie-se na documentação referida abaixo).</para> - -<para ->Suponha que você possui a seguinte linha: <programlisting ->void MinhaClasse::DoStringOps( String &foo, String &bar String *p, int &a, int &b )</programlisting> -</para> -<para ->Agora, você pode perceber que este não é um código bom, e decidir que deseja usar a palavra-chave <constant ->const</constant -> para todos os argumentos <quote ->address of</quote ->, aqueles caracterizados pelo operador & em frente ao nome do argumento. Você poderia também simplificar o espaço em branco, pois assim existiria somente um caractere de espaço em branco entre cada palavra.</para> - -<para ->Abra o Diálogo de Edição de Comando, e digite <userinput ->s/\s+(\w+)\s+(&)/ const \1 \2/g</userinput -> e clique no botão <guibutton ->OK</guibutton ->. O caractere <userinput ->g</userinput -> no final da expressão faz com que a expressão regular recompile cada combinação, para recuperar as <emphasis ->referências de volta</emphasis ->.</para> - -<para ->Saída <computeroutput ->void MinhaClasse::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b )</computeroutput -></para> - -<para ->Missão completa! Agora, o que aconteceu? Bem, procuramos por espaços em branco (<literal ->\s+</literal ->) seguidos por um ou mais caracteres alfabéticos(<literal ->\w+</literal ->) seguidos por mais espaços em branco (<literal ->\s+</literal ->) seguidos por um E comercial, e no processo é salvo o pedaço alfabético e o E comercial para reutilização na operação de substituição. Quando substituímos a parte relacionada da nossa linha, com um espaço em branco, seguido por <quote ->const</quote ->, seguido por um espaço em branco, seguido por nosso pedaço alfabético (<literal ->\1</literal ->) seguido por um espaço em branco, em por fim, seguido por nosso E comercial salvo (<literal ->\2</literal ->)</para> - -<para ->Em alguns casos, a parte alfabética foi <quote ->String</quote ->, em alguns <quote ->int</quote ->, assim, usar a classe de caractere <literal ->\w</literal -> e o quantificador <literal ->+</literal -> provê uma vantagem considerável.</para> - -</example> - -</listitem> - -</varlistentry> - -</variablelist> - -</sect3> - -<sect3 id="advanced-editing-tools-commandline-commands-navigation"> -<title ->Comandos de navegação</title> - -<variablelist> - -<varlistentry> -<term -><cmdsynopsis -><command ->goto</command -><arg ->INT linha</arg -></cmdsynopsis -></term> -<listitem -><para ->Este comando vai para a linha indicada.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->find</command -><arg ->padrão</arg -></cmdsynopsis -></term> -<listitem -><para ->Este comando vai para a primeira ocorrência do <userinput ->padrão</userinput ->, de acordo com a configuração. As ocorrências a seguir poderão ser encontradas com a opção <menuchoice -><guimenu ->Editar</guimenu -><guimenuitem ->Procurar Próximo</guimenuitem -></menuchoice -> (o atalho por padrão é o <keycap ->F3</keycap ->).</para> -<para ->O comando de procura poderá ser configurado adicionando dois-pontos, seguidos de uma ou mais opções, sendo o formato <userinput ->find:opções padrão</userinput ->. São suportadas as seguintes opções: <variablelist> - -<varlistentry> -<term -><userinput ->b</userinput -></term> -<listitem -><para ->Procura para trás.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->c</userinput -></term> -<listitem -><para ->Procura a partir da posição do cursor.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->e</userinput -></term> -<listitem -><para ->Procura apenas na área selecionada.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->r</userinput -></term> -<listitem -><para ->Faz uma pesquisa por uma determinada expressão regular. Se estiver ativo, você poderá usar o <userinput ->\N</userinput ->, onde o N é um número que representa as capturas no texto de substituição.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->s</userinput -></term> -<listitem -><para ->Faz uma pesquisa com distinção entre maiúsculas e minúsculas.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->w</userinput -></term> -<listitem -><para ->Faz uma correspondência apenas com palavras inteiras.</para -></listitem> -</varlistentry> - -</variablelist> - -</para> - -</listitem> - -</varlistentry> - -<varlistentry> -<term -><cmdsynopsis -><command ->ifind</command -><arg ->padrão</arg -></cmdsynopsis -></term> -<listitem -><para ->Este comando oferece uma procura <quote ->à-medida-que-digita</quote ->. Você poderá configurar o comportamento da procura adicionando dois-pontos (:), seguidos de uma ou mais opções, como se segue: <userinput ->ifind:opções padrão</userinput ->. As opções permitidas são <variablelist> -<varlistentry> -<term -><userinput ->b</userinput -></term> -<listitem -><para ->Procura para trás.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->r</userinput -></term> -<listitem -><para ->Faz uma procura por uma expressão regular.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->s</userinput -></term> -<listitem -><para ->Faz uma pesquisa com distinção entre maiúsculas e minúsculas.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><userinput ->c</userinput -></term> -<listitem -><para ->Procura a partir da posição do cursor.</para -></listitem> -</varlistentry> - -</variablelist> -</para -></listitem> -</varlistentry> - -</variablelist> - -</sect3> - -</sect2> - -</sect1> - -<sect1 id="advanced-editing-tools-code-folding"> -<title ->Usando o Desdobramento de Código</title> - -<para ->O desdobramento ou dobragem de código permite-lhe ocultar partes de um documento no editor, tornando mais simples analisar globalmente arquivos grandes. No &kate;, as regiões desdobráveis são calculadas com base nas regras das definições de realce de sintaxe; como tal só está disponível em alguns formatos - tipicamente em código-fonte de programas, código em XML e semelhantes. A maioria das definições de realce que suportam o desdobramento de código também lhe permitem definir manualmente regiões desdobráveis, tipicamente com as palavras-chave <userinput ->BEGIN</userinput -> e <userinput ->END</userinput ->.</para> - -<para ->Para usar a funcionalidade de desdobramento de código, ative os marcadores com a opção <menuchoice -><guimenu ->Ver</guimenu -><guimenuitem ->Mostrar as Marcações de Dobragem</guimenuitem -></menuchoice ->, se não estiverem já visíveis. A área de Marcações de Dobragem, no lado esquerdo da tela, mostra uma visão gráfica sobre as regiões que poderão ser recolhidas ou expandidas, com símbolos +/- para indicar a operação possível numa determinada região: um '-' significa que a região é expandida; enquanto clicar no '-' irá recolher a região, clicar no '+' irá exibí-la.</para> - -<para ->Estão disponíveis quatro comandos para manipular o estado das regiões dobradas; para tal, veja a <link linkend="view-code-folding" ->documentação do menu</link ->. </para> - -<para ->Se você não quiser usar a funcionalidade de desdobramento do código, poderá desativar a opção <guilabel ->Mostrar as marcações de dobragem (se disponíveis)</guilabel -> na <link linkend="config-dialog-editor-appearance" ->página de Aparência da configuração do editor</link -></para> - -</sect1> - -<sect1 id="advanced-editing-tools-scripting"> - -<title ->Programando o componente do editor com Javascript</title> - -<sect2 id="advanced-editing-tools-scripting-introduction"> - -<title ->Introdução</title> - -<para ->Desde a versão 2.5, o componente de edição do &kate; suporta a programação em ECMA Script, também conhecido como JavaScript.</para> - -<para ->Os programas só poderão ser usados através da <link linkend="advanced-editing-tools-commandline" ->linha de comando embutida</link ->. Os requisitos são que o arquivo esteja colocado numa pasta em que o &kate; o consiga encontrar, em conjunto com um arquivo .desktop opcional que define as propriedades relacionadas. Algumas pastas válidas são a <filename ->katepart/scripts</filename -> nas pastas de dados do &kde;. Você poderá encontrar as pastas de dados executando o comando <command ->kde-config <option ->--path</option -> <parameter ->data</parameter -></command -> Você terá pelo menos uma pasta do sistema e uma pessoal. Claro que os programas na pasta de dados do sistema estão disponíveis para todos os usuários do sistema, enquanto os das pastas pessoais só estão disponíveis para o respectivo usuário.</para> - -<note -><para ->Esta funcionalidade é experimental e poderá vir a mudar durante os desenvolvimentos futuros.</para> -<para ->Sabemos que muitos usuários poderão ficar desapontados, uma vez que não poderão adicionar os seus programas ao menu ou atribuir atalhos a eles. Infelizmente, só no futuro provavelmente isso será possível.</para> -<para ->Também não é possível passar argumentos aos seus programas ainda. Tenha paciência, que isso será implementado em breve no futuro ;)</para> -</note> - -</sect2> - -<sect2 id="advanced-editing-tools-scripting-reference"> - -<title ->A API de JavaScript do Kate</title> - -<para ->Aqui está listado o conjunto completo de funções e propriedades disponíveis nos objetos <type ->document</type -> e <type ->view</type ->. Além disso, você poderá também usar todos os objetos-padrão, como o <type ->Math</type ->, o <type ->String</type ->, o <type ->Regex</type -> e assim por diante.</para> - -<para ->Quando um programa é executado, o objeto <classname ->document</classname -> é o documento atual, enquanto o <classname ->view</classname -> é a janela atual.</para> - -<note -><para ->Os tipos dos argumentos não são, obviamente, usados no JavaScript neste momento, servindo apenas para indicar que tipo de valor as funções estão esperando.</para -></note> - -<variablelist id="advanced-editing-tools-scripting-global"> -<title ->Funções Globais</title> -<varlistentry> -<term -><function ->debug( <parameter -><replaceable ->texto</replaceable -></parameter ->) [função]</function -></term> -<listitem> -<itemizedlist> -<title ->parâmetros</title> -<listitem -><para -><parameter ->texto</parameter -> a mensagem a exibir</para> -</listitem> -</itemizedlist> -<para ->Envia o texto para o <acronym ->STDERR</acronym -> com o <function ->kdDebug()</function ->. É usada uma área de saída dedicada para o texto, o qual será antecedido de <computeroutput ->Kate (KJS Scripts):</computeroutput -> </para> -</listitem> -</varlistentry> -</variablelist> - -<variablelist id="advanced-editing-tools-scripting-document"> -<title ->A API do <classname ->document</classname -></title> - -<varlistentry> -<term -><function ->document.attribute( <parameter -><replaceable ->linha</replaceable -> </parameter ->, <parameter -><replaceable ->coluna</replaceable -></parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->uint linha</parameter -> A linha da posição onde encontrar o atributo.</para -></listitem> -<listitem -><para -><parameter ->uint coluna</parameter -> A coluna da posição onde encontrar o atributo.</para -></listitem> -</itemizedlist> -<para ->Devolve o ID numérico do atributo para a posição do documento [<parameter ->linha</parameter ->,<parameter ->coluna</parameter ->]. O atributo representa a aparência ou estilo visual do texto, e é usado também para calcular o realce de sintaxe para uma parte específica do texto, em formatos mixtos como o HTML ou o PHP.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.canBreakAt( <parameter ->Char c</parameter ->, <parameter ->uint atributo</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->c</parameter -> O caracter a testar</para -></listitem> -<listitem -><para -><parameter ->atributo</parameter -> O atributo na posição do <parameter ->c</parameter ->.</para -></listitem> -</itemizedlist> -<para ->Devolve se é permitido quebrar a linha num caracter 'c' com o atributo 'atributo'. O resultado é decidido através da pesquisa do realce que contém o atributo, para o qual os caracteres permitem a quebra de linha.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.canComment( <parameter ->uint atributo_inicio</parameter ->, <parameter ->uint atributo_fim</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->atributo_inicio</parameter -> O atributo no início do intervalo para converter num comentário.</para -></listitem> -<listitem -><para -><parameter ->atributo_fim</parameter -> O atributo no fim do intervalo para converter num comentário.</para -></listitem> -</itemizedlist> -<para ->Devolve se o atributo_inicio e o atributo_fim pertencem ao mesmo sistema de realce de sintaxe. Se sim, é seguro. </para> -<example> -<title ->Usando o canComment</title> -<programlisting ->if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) { - // o 1,0 e o 5,0 pertencem ao mesmo sistema de realce de sintaxe -} -</programlisting> -</example> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.clear(); [função]</function -></term> -<listitem -><para ->Limpa o documento.</para -></listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.commentStart( <parameter ->uint atributo</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->atributo</parameter -> O atributo do texto para qual deseja obter o texto do 'commentStart'.</para -></listitem> -</itemizedlist> -<para ->Devolve o texto necessário para iniciar um comentário para várias linhas com um texto e um atributo, ou um texto vazio se não forem suportados comentários em várias linhas para esse texto.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.commentMarker( <parameter ->uint atributo</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->atributo</parameter -> O atributo do texto para o qual deseja obter o texto do 'commentMarker'</para -></listitem> -</itemizedlist> -<para ->Devolve o texto necessário para marcar o resto da linha como um comentário com um texto e um atributo, ou um texto vazio se não forem suportados comentários numa única linha para esse texto.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.commentEnd( <parameter ->uint atributo</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->atributo</parameter -> O atributo do texto para o qual deseja obter o texto do 'commentEnd'</para -></listitem> -</itemizedlist> -<para ->Devolve o texto necessário para terminar um comentário para várias linhas com um texto e um atributo, ou um texto vazio se não forem suportados comentários em várias linhas para esse texto.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.editBegin(); [função]</function -></term> -<listitem> -<para ->Inicia um grupo de edição. Todas as ações feitas até à chamada do editEnd() serão agrupadas como uma ação anulável.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.editEnd(); [função]</function -></term> -<listitem> -<para ->Termina um grupo de edição.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.highlightMode; [propriedade:apenas leitura]</function -></term> -<listitem> -<para ->O nome do modo de realce do documento, como por exemplo JavaScript ou C++. Se não estiver definido qualquer modo de realce de sintaxe, o valor é igual a None. Lembre-se que terá de usar o nome em Inglês, no caso de ser diferente da versão traduzida.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.indentMode; [propriedade:apenas leitura]</function -></term> -<listitem> -<para ->O nome do modo de indentação do documento, como por exemplo <literal ->normal</literal -> ou <literal ->cstyle</literal ->. Lembre-se que, se não estiver definido qualquer modo de indentação, o valor é igual a <literal ->none</literal ->. </para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.indentWidth; [propriedade:apenas leitura]</function -></term> -<listitem> -<para ->A largura da indentação do documento. Isto é usado se você indentar com espaços.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.insertLine( <parameter ->uint linha</parameter ->, <parameter ->string texto</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->linha</parameter -> número de linha do documento</para> -</listitem> -<listitem -><para -><parameter ->texto</parameter -> o texto a inserir</para -></listitem> -</itemizedlist> -<para ->Insere uma linha nova com o texto <parameter ->texto</parameter -> na linha <parameter ->linha</parameter ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.insertText( <parameter ->uint linha</parameter ->, <parameter ->uint coluna</parameter ->, <parameter ->string texto</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->linha</parameter -> o número de linha</para -></listitem> -<listitem -><para -><parameter ->coluna</parameter -> o número da coluna</para -></listitem> -<listitem -><para -><parameter ->texto</parameter -> o texto a inserir</para -></listitem> -</itemizedlist> -<para ->Insere o texto <parameter ->texto</parameter -> na linha <parameter ->linha</parameter -> e coluna <parameter ->coluna</parameter ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term ->document.length(); [função]</term> -<listitem> -<para ->Devolve o tamanho do documento em 'bytes'.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.lines(); [função]</function -></term> -<listitem> -<para ->Devolve o número de linhas do documento.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term ->document.mixedIndent; [propriedade:apenas leitura]</term> -<listitem> -<para ->Um booleano que lhe diz se a opção 'mixed-indent' está ativa para o documento. Se sim, a indentação é otimizada para conter uma mistura de tabulações e espaços, como acontece no editor Emacs.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term ->document.removeLine( <parameter ->uint linha</parameter -> ); [função]</term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->linha</parameter -> o número de linha</para -></listitem> -</itemizedlist> -<para ->Remove a linha especificada do documento.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.removeText( <parameter ->uint linhaInicial</parameter ->, <parameter ->colunaInicial</parameter ->, <parameter ->uint linhaFinal</parameter ->, <parameter ->uint colunaFinal</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->linhaInicial</parameter -> corresponde à linha inicial</para -></listitem> -<listitem -><para -><parameter ->colunaInicial</parameter -> corresponde à coluna inicial</para -></listitem> -<listitem -><para -><parameter ->linhaFinal</parameter -> corresponde à linha final</para -></listitem> -<listitem -><para -><parameter ->colunaFinal</parameter -> corresponde à coluna final</para -></listitem> -</itemizedlist> -<para ->Remove o intervalo de texto da linha <parameter ->linhaInicial</parameter -> e coluna <parameter ->colunaInicial</parameter -> até à linha <parameter ->linhaFinal</parameter -> e coluna <parameter ->colunaFinal</parameter ->. </para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.setText( <parameter ->string texto</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->texto</parameter -> o texto do documento</para -></listitem> -</itemizedlist> -<para ->Configura o conteúdo inteiro do documento como <parameter ->texto</parameter ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.spaceIndent; [propriedade:apenas leitura]</function -></term> -<listitem> -<para ->Um booleano que indica se o 'space-indent' está ativo para o documento. Se for o caso, o documento é indentado com larguraIndentacao espaços por nível, caso contrário, a indentação corresponde a uma tabulação por nível.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.textFull(); [função]</function -></term> -<listitem> -<para ->Devolve o conteúdo completo do documento. Se o texto se espalhar por várias linhas, o carácter de mudança de linha é o <constant ->\n</constant ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.textLine( uint linha ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->linha</parameter -> a linha</para -></listitem> -</itemizedlist> -<para ->Devolve o texto da linha <parameter ->linha</parameter ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->document.textRange( <parameter ->uint linhaInicial</parameter ->, <parameter ->uint colunaInicial</parameter ->, <parameter ->uint linhaFinal</parameter ->, <parameter ->uint colunaFinal</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->linhaInicial</parameter -> corresponde à linha inicial</para -></listitem> -<listitem -><para -><parameter ->colunaInicial</parameter -> corresponde à coluna inicial</para -></listitem> -<listitem -><para -><parameter ->linhaFinal</parameter -> corresponde à linha final</para> -</listitem> -<listitem -><para -><parameter ->colunaFinal</parameter -> corresponde à coluna final</para -></listitem> -</itemizedlist> -<para ->Devolve o intervalo de texto indicado. Se o intervalo se espalhar por várias linhas, o caracter de mudança de linha é o <constant ->\n</constant ->.</para> -</listitem> -</varlistentry> - -</variablelist -><!--/ document API --> - -<variablelist id="advanced-editing-tools-scripting-view"> -<title ->A API do <classname ->view</classname -></title> - -<varlistentry> -<term -><function ->view.clearSelection(); [função]</function -></term> -<listitem> -<para ->Remove a seleção de todo o texto.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.cursorColumn(); [função]</function -></term> -<listitem> -<para ->Devolve a coluna atual do cursor (os caracteres TAB são expandidos).</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.cursorColumnReal(); [função]</function -></term> -<listitem> -<para ->Devolve a coluna real do cursor (os caracteres TAB contam como um).</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.cursorLine(); [função]</function -></term> -<listitem> -<para ->Devolve a linha atual do cursor.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.hasSelection(); [função]</function -></term> -<listitem> -<para ->Devolve <constant ->true</constant -> (verdadeiro) se a janela contiver algum texto selecionado, caso contrário devolve <constant ->false</constant ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.removeSelectedText(); [função]</function -></term> -<listitem> -<para ->Remove o texto selecionado, se a janela tiver alguma seleção.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.selectAll(); [função]</function -></term> -<listitem> -<para ->Seleciona todo o texto.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.selection(); [função]</function -></term> -<listitem> -<para ->Devolve o texto selecionado. Se a seleção se espalhar por várias linhas, o caracter de mudança de linha é o <constant ->\n</constant ->.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.selectionEndColumn; [propriedade:apenas leitura]</function -></term> -<listitem> -<para ->Devolve a coluna final da seleção.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.selectionEndLine; [propriedade:apenas leitura]</function -></term> -<listitem> -<para ->Devolve a linha final da seleção.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.selectionStartColumn; [propriedade:apenas leitura]</function -></term> -<listitem> -<para ->Devolve a coluna inicial da seleção.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.selectionStartLine; [propriedade:apenas leitura]</function -></term> -<listitem> -<para ->Devolve a linha inicial da seleção.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.setCursorPosition( <parameter ->uint linha</parameter ->, <parameter ->uint coluna</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->linha</parameter -> Indica a linha para o cursor.</para -></listitem> -<listitem -><para -><parameter ->coluna</parameter -> Indica a coluna para o cursor.</para -></listitem> -</itemizedlist> -<para ->Configura a posição atual do cursor na janela como sendo [<parameter ->linha</parameter ->, <parameter ->col</parameter ->]. A posição do cursor é a nível visual, isto é, um caracter TAB conta como <replaceable ->tab-width</replaceable -> espaços, dependendo da posição dentro da linha. A posição do cursor é tornada visível. Tanto a linha como a coluna começam em zero.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.setCursorPositionReal( <parameter ->uint linha</parameter ->, <parameter ->uint coluna</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->linha</parameter -> Indica a linha para o cursor.</para -></listitem> -<listitem -><para -><parameter ->coluna</parameter -> Indica a coluna para o cursor.</para -></listitem> -</itemizedlist> -<para ->Configura a posição atual do cursor na janela como sendo [<parameter ->linha</parameter ->, <parameter ->col</parameter ->]. A posição do cursor é a nível do texto, isto é, um caracter TAB conta como 1. A posição do cursor é tornada visível. Tanto a linha como a coluna começam em zero.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term -><function ->view.setSelection( <parameter ->uint linhaInicial</parameter ->, <parameter ->uint colunaInicial</parameter ->, <parameter ->uint linhaFinal</parameter ->, <parameter ->uint colunaFinal</parameter -> ); [função]</function -></term> -<listitem> -<itemizedlist> -<title ->Parâmetros</title> -<listitem -><para -><parameter ->linhaInicial</parameter -> corresponde à linha inicial</para -></listitem> -<listitem -><para -><parameter ->colunaInicial</parameter -> corresponde à coluna inicial</para -></listitem> -<listitem -><para -><parameter ->linhaFinal</parameter -> corresponde à linha final</para -></listitem> -<listitem -><para -><parameter ->colunaFinal</parameter -> corresponde à coluna final</para -></listitem> -</itemizedlist> -<para ->Configura a seleção desde a linha <parameter ->linhaInicial</parameter -> e coluna <parameter ->colunaInicial</parameter -> até à linha <parameter ->linhaFinal</parameter -> e coluna <parameter ->colunaFinal</parameter ->.</para> -</listitem> -</varlistentry> - -</variablelist> - -<example id="advanced-editing-tools-scripting-example"> - -<title ->Um programa de exemplo</title> -<para ->Como exemplo, será criado um pequeno programa que converte o texto selecionado para maiúsculas. É óbvio que se deverá ver primeiro se existe texto selecionado, para que se possa obter o texto, mudar a capitalização e depois substituir pelo novo. Uma implementação possível seria do género:</para> - -<programlisting ->if ( view.hasSelection() ) -{ - // seleção para maiúsculas - column = view.selectionStartColumn; - line = view.selectionStartLine; - - selection = view.selection().toUpperCase(); - - document.editBegin(); - view.removeSelectedText(); - document.insertText( line, column, selection ); - document.editEnd(); -} -</programlisting> - -<para ->Para agrupar esta ação em conjunto, para que possam ser anuladas com uma única ativação do <guimenuitem ->Desfazer</guimenuitem ->, as linhas <programlisting ->view.removeSelectedText()</programlisting -> e <programlisting ->document.insertText()</programlisting -> são encapsuladas com um <programlisting ->document.editBegin()</programlisting -> e <programlisting ->document.editEnd()</programlisting ->.</para> - -</example> - -<example id="advanced-editing-tools-desktop-example"> -<title ->Um arquivo <filename ->.desktop</filename -> de exemplo</title> - -<para ->Aqui está um arquivo .desktop de exemplo que acompanha o programa acima.</para> - -<programlisting -># Exemplo de um arquivo .desktop -[Desktop Entry] -Encoding=UTF-8 -Name=Kate Part JavaScript Uppercase -Comment=Script to uppercase the selection -X-Kate-Command=uppercase-selection -X-Kate-Help=<p>Usage: <code>uppercase-selection</code></p> -</programlisting> - -<para ->Como você pode ver, você pode definir a codificação, definir um nome, comentário, um texto de ajuda com o X-Kate-Help e o nome da linha de comando com o X-Kate-Command. Os itens Name, Comment e X-Kate-Help são traduzidos automaticamente para outros idiomas pelas equipes de traduções do KDE, se os arquivos estiverem no repositório de SVN do KDE.</para> - -</example> - -<sect3> -<title ->Colocando tudo junto</title> - -<para ->O &kate; irá procurar nas pastas de programas (ver <link linkend="advanced-editing-tools-scripting-introduction" ->acima</link ->) por arquivos <filename ->*.js</filename ->. Para cada um deles, verifica se existe um arquivo <filename ->.desktop</filename -> correspondente, como por exemplo, maiusculas.js corresponderia a maiusculas.desktop. </para> -<para ->Se não for encontrado um arquivo <filename ->.desktop</filename ->, o programa será registrado na linha de comando com o nome do arquivo sem o '.js' final, para que, no nosso exemplo, fosse <literal ->maiusculas</literal ->. Se o nome do comando for aceitável e não necessitar de funcionalidades extras de um arquivo <filename ->.desktop</filename ->, não será necessário um arquivo <filename ->.desktop</filename ->. </para> -<para ->Se o arquivo <filename ->.desktop</filename -> existir, o 'katepart' irá ler o nome sob o qual o programa será registrado, a partir do item do '.desktop' X-Kate-Command, como por exemplo X-Kate-Command=uppercase-selection.</para> - -</sect3> - -</sect2> - -</sect1> - -</chapter> |