# useraction.xml

Este apêndice dá-lhe diversos exemplos de ficheiros `useraction.xml`. Com isto, poderá começar a descobrir o poder das Acções do Utilizador e começar a aprender como usá-las. Assim que compreender como pode criar Acções do Utilizador, irá descobrir que o &krusader; é uma ferramenta ainda mais poderosa e configurável.

Pense por favor em enviar as suas acções do utilizador para o kde-files.org, já que as estamos a coleccionar. Se a sua acção do utilizador for seleccionada por nós, será incluída na próxima versão do &krusader;. Oferecemos também um Fórum de Acções do Utilizador.

- Executa o `uptime`

      <!DOCTYPE KrusaderUserActions>
       <KrusaderUserActions>
        <action name="uptime" >
        <title
      >Up-time</title>
        <tooltip
      >diz há quanto tempo o computador foi iniciado</tooltip>
        <icon
      >clock</icon>
        <category
      >Informação</category>
        <description same_as="tooltip" />
        <command executionmode="collect_output"
      >uptime</command>
        <defaultshortcut
      >Alt+Ctrl+U</defaultshortcut>
       </action>
      </KrusaderUserActions
      >

- Executa o `ls -l`

      <!DOCTYPE KrusaderUserActions>
       <KrusaderUserActions>
        <action name="ls -l" >
        <title
      >Executar o comando 'ls -l' na pasta actual</title>
        <description same_as="tooltip" />
        <command executionmode="collect_output"
      >ls -l %aPath% %oPath%</command>
       </action>
      </KrusaderUserActions
      >

- Substituição do 'Echo'

      <!DOCTYPE KrusaderUserActions>
       <KrusaderUserActions>
        <action name="test_placeholder" >
        <title
      >Echo Placeholder</title>
        <tooltip
      >'Echo' dos valores de substituição</tooltip>
        <category
      >Testes</category>
        <description same_as="tooltip" />
        <command executionmode="collect_output" onmultiplefiles="call_each"
      >echo -e "aPath %aPath()%  \naCurrent: %aCurrent()%"</command>
       </action>
      </KrusaderUserActions
      >

- Esta acção do utilizador copia a localização e o nome do ficheiro actual para a área de transferência:

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
       <action name="clipboard current" >
        <title
      >Copiar para a Área de Transferência</title>
        <tooltip
      >Copiar para a área de transferência</tooltip>
        <icon
      >klipper</icon>
        <category
      >System</category>
        <description
      >Copiar a localização e nome do ficheiro actual para a área de transferência</description>
        <command
      >%_Clipboard("%aCurrent%")%</command>
        <defaultshortcut
      >Win+C</defaultshortcut>
       </action>
      </KrusaderUserActions
      >

- Seleccione os ficheiros `.diff` e `*.h` no painel activo:

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
       <action name="test_select" >
        <title
      >Adicionar a selecção do '*.diff' e do '*.h'</title>
        <category
      >Selecção</category>
        <command
      >%aSelect("*.diff", "add")% %aSelect("*.h", "add")%</command>
       </action>
      </KrusaderUserActions
      >

- O painel activo muda para o `mnt/floppy` (favorito):

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
      <action name="mnt/floppy bookmark" >
        <title
      >Ir para o /mnt/floppy</title>
        <category
      >Favoritos</category>
        <command
      >%aGoto("/mnt/floppy", "yes")%</command>
       </action>
      </KrusaderUserActions
      >

- Selecciona, no painel não activo, todos os ficheiros que estejam realçados no painel activo:

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
       <action name="asdfasdf" >
        <title
      >Seleccionar no Outro Painel</title>
        <category
      >Selecção</category>
        <description
      >Seleccionar todos os nomes de ficheiros que estejam tanto no painel activo como no não-activo</description>
        <command
      >%oSelect("%aList("selected", " ", "Yes")%")%</command>
       </action>
      </KrusaderUserActions
      >

- Faz uma cópia de segurança do ficheiro/pasta actual para `xpto.bak`, na pasta actual:

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
       <action name="backup current" >
        <title
      >Salvaguardar na Pasta Actual</title>
        <tooltip
      >Cria uma cópia de segurança na pasta actual</tooltip>
        <icon
      >filesaveas</icon>
        <category
      >Sistema</category>
        <description same_as="tooltip" />
        <command
      >%_Copy("%aCurrent%", "%_Ask("new name", "%aCurrent%.bak")%")%</command>
        <defaultshortcut
      >Shift+F5</defaultshortcut>
       </action>
      </KrusaderUserActions
      >

- Abre o KruSearcher:

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
       <action name="search" >
        <title
      >Teste de Pesquisa</title>
        <command
      >%_NewSearch("Search 2")%</command>
       </action>
      </KrusaderUserActions
      >

- Configura a imagem seleccionada como papel de parede:

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
       <action name="set wallpaper" >
        <title
      >Colocar como Papel de Parede</title>
        <tooltip
      >Colocar como papel de parede</tooltip>
        <icon
      >image</icon>
        <category
      >Menu de Serviços</category>
        <description
      >Colocar como papel de parede (escalado)</description>
        <command
      >dcop kdesktop KBackgroundIface setWallpaper "%aCurrent%" 6</command>
        <defaultshortcut
      >Win+W</defaultshortcut>
       </action>
      </KrusaderUserActions
      >

- Esta acção do utilizador edita um ficheiro com permissões de 'root', usando o `kdesu`:

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
       <action name="edit as root" >
        <title
      >Editar como 'Root'</title>
        <tooltip
      >Editar como 'root'</tooltip>
        <icon
      >kwrite</icon>
        <category
      >Sistema</category>
        <description
      >Edita um ficheiro com permissões de 'root', usando o 'kdesu'</description>
        <command
      >kdesu kedit %aCurrent%</command>
        <defaultshortcut
      >Win+F4</defaultshortcut>
       </action>
      </KrusaderUserActions
      >

- Esta acção do utilizador adiciona itens à lista de reprodução do Amarok:

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
       <action name="amarok enqueue" >
        <title
      >Colocar na fila do Amarok</title>
        <tooltip
      >Adicionar os itens seleccionados à lista de reprodução do Amarok</tooltip>
        <icon
      >amarok</icon>
        <category
      >Multimédia</category>
        <description same_as="tooltip" />
        <command
      >amarok --append %aList("Selected")%</command>
        <defaultshortcut
      >Win+A</defaultshortcut>
       </action>
      </KrusaderUserActions
      >

- Abre a Sincronização:

      <!DOCTYPE KrusaderUserActions>
      <KrusaderUserActions>
       <action name="synchronizer" >
        <title
      >Sincronização</title>
        <command
      >%_Sync("Sync 2")%</command>
       </action>
      </KrusaderUserActions
      >