[Notes2-team] =?ISO-8859-1?Q?Notes_com_suporte_a_Macros_em_JavaScr?= =?ISO-8859-1?Q?ipt!_Adeus_conc

SourceForge Headquarters 225 Broadway Suite 1600 San Diego, CA 92101 +1 (858) 422-6466

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html; charset=ISO-8859-1"
 http-equiv="content-type">
  <title>Notes Script Api</title>
</head>
<body>
<h1>Scripts do Notes</h1>
<h2>1. A linguagem de script do Notes</h2>
A linguagem de script do Notes &eacute; JavaScript 1.5. O Notes usa a
mesma engine de script (chamada de SpiderMonkey) que os navegadores do
projeto Mozilla e de muitos produtos da Macromedia. Portanto, todos a
especifica&ccedil;&atilde;o da linguagem JavaScript &eacute; suportada.
Por&eacute;m, a DOM, que n&atilde;o faz parte da linguagem, n&atilde;o
&eacute; suportada pelo Notes (ou seja, objetos como window, form,
document, etc. n&atilde;o funcionam). No lugar da DOM o Notes traz uma
API pr&oacute;pria e completa que permite interagir com os sistemas
internos do Notes, manipular arquivos, executar programas, etc. Esta
API &eacute; descrita no cap&iacute;tulo 2. O cap&iacute;tulo 3
apresenta as a&ccedil;&otilde;es internas do Notes, a&ccedil;&otilde;es
dos pain&eacute;is e propriedades dos pain&eacute;is que podem ser
manipuladas atrav&eacute;s de algumas fun&ccedil;&otilde;es descritas
no cap&iacute;tulo 2. <br>
<br>
<h2>2. Fun&ccedil;&otilde;es e objetos <br>
</h2>
<h3>2.1. Fun&ccedil;&otilde;es para interagir com o Notes <br>
</h3>
V&aacute;rias fun&ccedil;&otilde;es que permitem receber
informa&ccedil;&otilde;es sobre o Notes, executar a&ccedil;&otilde;es
internas do Notes, se comunicar com os pain&eacute;is, etc.<br>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">&nbsp;notesExec(
ActionName );</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Executa
uma a&ccedil;&atilde;o interna do Notes. Passe o nome da
a&ccedil;&atilde;o como uma string. Veja a lista de a&ccedil;&otilde;es
no final deste documento.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:
      <br>
      <pre>//Mostra o di&aacute;logo para criar novos arquivos<br>notesExec('actFileNew');<br><br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">&nbsp;notesPanelExec(
PanelName, ActionName, Params );</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Executa
uma a&ccedil;&atilde;o interna de um dos pain&eacute;is do Notes. Passe
o nome do painel, o nome da
a&ccedil;&atilde;o e o par&acirc;metros da a&ccedil;&atilde;o como
strings. Veja as apis para cada painel no fim do documento. </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:
      <br>
      <pre>// Imprime "hello world" no painel de sa&iacute;da<br>notesPanelExec('Output', 'add', 'Hello World!');<br><br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">&nbsp;notesPanelSetProperty(PanelName,
PropertyName, Value);</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Modifica
o valor de uma propriedade de um dos pain&eacute;is do Notes. Passe o
nome do painel, o nome da propriedade e o novo valor como strings. Veja
as apis para cada painel no fim do documento. </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:
      <br>
      <pre>// Faz o painel biblioteca exibir os c&oacute;digos para java script<br>notesPanelSetProperty('Library', 'FileType', 'JavaScript');<br><br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">notesPanelGetProperty(Name,
PropertyName) </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">L&ecirc;
o valor de uma propriedade de um dos pain&eacute;is do Notes.
Passe o
nome do painel e o nome da propriedade, o valor ser&aacute; retornado
na forma de uma string. Voc&ecirc; pode usar fun&ccedil;&otilde;es do
JavaScript para converter o valor para outros tipos - mas em geral
voc&ecirc; querer os valores em strings mesmo. Veja
as apis para cada painel no fim do documento para saber sobre as
propriedades dispon&iacute;veis.</td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Armazena na vari&aacute;vel o tipo de arquivo que est&aacute; sendo mostrado <br>// no painel biblioteca<br>CurrentLibraryLanguage= notesPanelGetProperty('Library', 'FileType');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">getNotesSettingsDir
()</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Retorna
o diret&oacute;rio em que est&atilde;o as
configura&ccedil;&otilde;es do Notes<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>dir= getNotesSettingsDir();<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">getNotesDir()
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Retorna
o diret&oacute;rio em que o Notes est&aacute; instalado<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>dir= getNotesDir();<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">getActiveProfile()</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Retorna
o profile atual.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Acha o diret&oacute;rio de macros <br>macrosDir= getNotesSettingsDir() + 'profiles\' + getActiveProfile() + '\macros\';<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<br>
<h3>2.2. Fun&ccedil;&otilde;es do sistema operacional</h3>
Fun&ccedil;&otilde;es que permitem receber e modificar
informa&ccedil;&otilde;es do sistema operacional, executar programas,
etc.<br>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">shellExec(
ProgramToRun, Args )</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Executa
um programa. Passe o programa como primeiro par&acirc;metro e
os argumentos que voc&ecirc; quer passar para ele no segundo.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Roda o Notes<br>shellExec(getNotesDir() + 'Notes.exe', ''); <br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">getClipboard
()</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Retorna
o conte&uacute;do da &aacute;rea de transfer&ecirc;ncia.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// cola o texto da &aacute;rea de transfer&ecirc;ncia no Notes<br>editor.selText= getClipboard();<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">setClipboard(Value)
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Envia
para a &aacute;rea de transfer&ecirc;ncia o conte&uacute;do
passado.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// O mesmo que fazer um notesExec('actEditCopy'), ou seja, copiar<br>setClipboard( editor.selText );<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">setEnv(name,
value) </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Modifica
o valor da vari&aacute;vel de ambiente passada em "name" para
value. Se a vari&aacute;vel de ambiente n&atilde;o existir, ela
ser&aacute; criada.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>setEnv('HOME', 'C:\');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">getEnv(name)
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Pega
o valor de uma vari&aacute;vel de ambiente.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>homeEnvVar= getEnv('HOME');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">getCurDir()</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">L&ecirc;
o diret&oacute;rio atual do sistema operacional<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>curDir= getCurDir();<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">setCurDir(dirname)
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Modifica
o diret&oacute;rio atual para o valor passado.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>setCurDir( getEnv('HOME') );<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<br>
<h3>2.3. O objeto "editor"</h3>
O objeto "editor" permite a voc&ecirc; acessar as propriedades e
m&eacute;todos do editor ativo.<br>
Para verificar se h&aacute; um editor ativo, voc&ecirc; pode ler a
propriedade isActive. Veja<br>
todas as propriedades e m&eacute;otodos abaixo:<br>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.insert(str)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Insere
a string passada no editor.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>editor.insert('Hello word'); <br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.text
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
acessar todo o conte&uacute;do do editor atual.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Manipula o texto do editor atual, acrescentando "aham!"<br>s= editor.text;<br>s= s + 'aham!';<br>editor.text= s;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.selText
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
acessar o texto selecionado.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>s= editor.selText;<br>s= s + 'adicionando aham a sele&ccedil;&atilde;o!';<br>editor.selText= s; <br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.lineText</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
acessar o conte&uacute;do da linha atual<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Deleta o conte&uacute;do da linha atual<br>editor.lineText= '';<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.line</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
acessar o n&uacute;mero da linha em que est&aacute; o cursor.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Pula 10 linhas<br>editor.line = editor.line + 10;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.col</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
acessar a coluna que que est&aacute; ao cursor.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Vai para a &uacute;ltima coluna da linha<br>s = editor.lineText;<br>editor.col= s.length; <br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.selStart
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
acessar a posi&ccedil;&atilde;o do caret e onde est&aacute; o
in&iacute;cio da sele&ccedil;&atilde;o atual.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Move o caret para o primeiro caracter do texto<br>editor.selStart = 1;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.selLength
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
ler e modificar o n&uacute;mero de caracteres selecionados.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// seleciona 10 caracteres<br>editor.selLength= 10;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.linesCount
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
descobrir quantas linhas tem o texto atual. <span
 style="font-style: italic;">N&atilde;o</span> &eacute; poss&iacute;vel
modificar o n&uacute;mero de linhas usando est&aacute; propriedade,
apenas descobrir quantas linhas o texto tem.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>txtLines = editor.linesCount;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.saveView
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Faz
o editor gravar a posi&ccedil;&atilde;o em que o caret est&aacute;.
&Eacute; poss&iacute;vel retornar a posi&ccedil;&atilde;o usando
restoreView(). Use quando voc&ecirc; pretende voltar a
posi&ccedil;&atilde;o em que estava no texto ap&oacute;s fazer
modifica&ccedil;&otilde;es.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// salva a posi&ccedil;&atilde;o do texto (para voltar ao mesmo lugar depois)<br>editor.saveView();<br><br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.restoreView</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Volta
ao lugar em que o editor estava quando saveView foi chamado.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// volta ao lugar em que o cursor estava quando saveView foi chamado<br>editor.restoreView();<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.fileType</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Tipo
de arquivo do arquivo atual. </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Sincroniza o tipo de arquivo atual com o tipo de arquivo<br>// que est&aacute; sendo mostrado na biblioteca<br>editor.fileType= getNotesPanelProperty('Library', 'FileType');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.tabSize</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Tamanho
usado para o caracter tab.<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>if (editor.tabSize == editor.indentSize) {<br>  alert('O tamanho da identa&ccedil;&atilde;o e do caracter tab s&atilde;o iguais!!!');<br>}<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.indentSize</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Tamanho
da identa&ccedil;&atilde;o </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Modifica o tamanho da identa&ccedil;&atilde;o para o tamanho do caracter tab<br>editor.indentSize = editor.tabSize;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.modified
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Dize
se o texto foi modificado e permite mudar isto.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Faz o Notes pensar que o texto n&atilde;o foi modificado<br>editor.modified = false;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.isReadOnly</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Diz
se o texto pode ser modificado. </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Pro&iacute;be que mudan&ccedil;as sejam feitas no arquivo<br>editor.isReadOnly= true;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">editor.isActive
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Diz
se h&aacute; um editor ativo (pode n&atilde;o ter arquivo aberto ou
estar mostrando a StartPage!). Essa propriedade n&atilde;o pode ser
modificada.<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>if (editor.isActive == true){ <br>  editor.insert('Hi!');<br>}<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<h3>2.4. O objeto "tabs"</h3>
O objeto tabs permite manipular as tabs (cada documento aberto no Notes
&eacute; uma tab) abertas no Notes. Voc&ecirc; pode ir de uma tab para
outra, descobrir que arquivo est&aacute; sendo mostrado na tab atual,
etc.<br>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.nextTab()</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Vai
para o pr&oacute;ximo documento.<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>tabs.nextTab();<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.previusTab()</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Vai
para o documento anterior.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>tabs.previusTab();<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.gotoFile(fileName)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">&nbsp;Vai
para a tab do arquivo passado.<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>tabs.gotoFile( 'Nome do arquivo' );<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.gotoFileAndMarkLine(fileName,
line)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
marcar em vermelho (ou outra cor para erros configurada pelo
usu&aacute;rio) a linha passada.<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Marca a linha 10 do documento atual<br>tabs.gotoFileAndMarkLine(tabs.activeFileName, 10);<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.activeTabIndex
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permiter
ler e modificar o index da tab atual.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Muda de tab e volta para o mesmo lugar <br>i= tabs.activeTabIndex;<br>tabs.nextTab();<br>tabs.activeTabIndex= i;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.activeTabCaption</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Permite
ler o t&iacute;tulo da tab atual (normalmente o nome do
arquivo, mas pode ser "Documento 1", por exemplo, se o arquivo ainda
n&atilde;o tiver sido salvo).<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>alert(tabs.activeTabCaption);<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.activeFileName</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">&nbsp;Nome
do arquivo atual. Essa propriedade n&atilde;o pode ser modificada, mas
voc&ecirc; pode usar o m&eacute;todo gotoFile do objeto tabs para ir
para um determinado arquivo.<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>alert(tabs.activeFileName);<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.openFile(fileName);
      </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Abre
o arquivo passado em fileName.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// abre o readme do Notes<br>tabs.openFile(getNotesDir() + 'reame.txt'); <br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.activeTabType;</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">&nbsp;Tipo
da tab atual. Use para saber se a tab atual &eacute; um arquivo nunca
salvo ou se &eacute; a StartPage, etc. Retorna startpage, newfile, file
ou none.<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>if (tabs.activeTabType == 'newfile') {<br>    alert('Voc&ecirc; nunca salvou este arquivo na vida!!!');<br>}<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">tabs.count</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">N&uacute;mero
total de tabs abertas no Notes. Voc&ecirc; pode usar isto
para circular em todas as tabs em um loop e assim alterar todos os
arquivos.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Salva todos os arquivos<br>for(var i= 0; i &lt; tabs.count; i++){<br>  tabs.activeTabIndex= i;<br>  notesExec('actFileSave');<br>}<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<h3>2.5. Fun&ccedil;&otilde;es para lidar com arquivos e
diret&oacute;rios</h3>
V&aacute;rias fun&ccedil;&otilde;es para lidar com arquivos e
diret&oacute;rios. Note que as fun&ccedil;&otilde;es que manipulam
aquivos tem o nome iniciado por "file" enquanto as que manipulam apenas
diret&oacute;rios, iniciam sempre por "dir". Ent&atilde;o para copiar
um arquivo voc&ecirc; usa fileCopy e para copiar um diret&oacute;rio,
dirCopy. <br>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">fileGetContents(filename)
string</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">L&ecirc;
o arquivo passado e retorna o conte&uacute;do dele como uma
string.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// vemos se o texto atual &eacute; igual ao do arquivo salvo. Se for,<br>// tiramos o status de modificado do arquivo <br>if (editor.modified = true &amp;&amp; tabs.activeTabType == 'file'){<br>  if (editor.text == fileGetContents(tabs.activeFileName)){<br>    editor.modified = false; <br>  }<br>}<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">filePutContents(filename,
content)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Salva
a string passada em content para um arquivo.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Salva apenas o conte&uacute;do selecionado para o arquivo <br>filePutContents(tabs.activeFileName, editor.selText);<br>// Mostramos o resultado para o us&uacute;ario<br>editor.text = editor.selText;<br>// removemos o estatus de modificado<br>editor.modified = false;<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">fileCopy(fromfile,
tofile [, overwrite = true])</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Copia
um arquivo para outro lugar. O &uacute;ltimo par&acirc;metro
&eacute; opcional e indica o que fazer se o arquivo especificado em
"tofile" j&aacute; existir. Se voc&ecirc; passar true, ele vai
sobrescrever o arquivo existente. Se voc&ecirc; passar false, ele
n&atilde;o vai copiar. Se voc&ecirc; n&atilde;o especificar um valor,
ele ser&aacute; setado para true. A fun&ccedil;&atilde;o retorna true
se conseguir copiar e false se algo der errado.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Faz o backup do arquivo atual<br>fileCopy(tabs.activeFileName, '~' + tabs.activeFileName);<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">fileDelete(filename)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Deleta
um arquivo <span style="font-style: italic;">sem pedir
confirma&ccedil;&atilde;o e sem mover para lixeira</span>. Tenha
cuidado ao usar esta fun&ccedil;&atilde;o!<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Deleta o arquivo que o Notes est&aacute; mostrando<br>if (confirmDlg('Voc&ecirc; quer mesmo deletar este arquivo?!?!') == 'yes') {<br>  editor.modified= false;<br>  flname= tabs.activeFileName;<br>  notesExec('actFileClose');<br>  fileDelete(flname);<br>}<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">fileSearch(dirname
[, mask = '*'] [, recursive = false]) </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Busca
arquivos e pastas em um diret&oacute;rio usando a masc&aacute;ra
passada em mask. Retorna uma string com os arquivos e pastas
encontrados separados pelo caracter #10. O par&acirc;metro mask
&eacute; opcional e no caso de n&atilde;o ser passado usa "*". O
par&acirc;metro recursive tamb&eacute;m &eacute; opcional (false se
omitido), e especifica se a busca deve incluir os subdiret&oacute;rios
recursivamente. Todos os caminhos para diret&oacute;rios retornados
possuem um "\" como &uacute;ltimo caracter (assim voc&ecirc; pode saber
se se trata de um arquivo ou de um diret&oacute;rio com
seguran&ccedil;a).<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Lista todos os arquivos no diret&oacute;rio do Notes<br>var searchresult= new String( fileSearch( getNotesDir() , '*', true) );<br>// coloca o resultado em um array<br>arraydecaminhos= searchresult.split( String.fromCharCode(10) );<br>// conta o n&uacute;mero de diret&oacute;rios<br>dircount = 0;<br>for (var i in arraydecaminhos){<br>&nbsp;&nbsp;&nbsp; caminho = new String(arraydecaminhos[i]);<br>&nbsp;&nbsp;&nbsp; if (caminho[caminho.length-1] == '\\'){<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; dircount = dircount + 1;<br>&nbsp;&nbsp;&nbsp; }<br>}<br>alert('O diret&oacute;rio do Notes tem ' + dircount + ' subdiret&oacute;rios!');</pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">fileIsReadOnly(filename)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Retorna
true se o arquivo passado como par&acirc;metro for readonly. </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>isRO= fileIsReadOnly( tabs.activeFileName );<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">fileSize(filename)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Retorna
o tamanho do arquivo no HD.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Mostra o n&uacute;mero de caracteres acrescentados ao arquivo<br>// atual desde a &uacute;ltima vez que ele foi salvo<br>if (editor.modified = true &amp;&amp; tabs.activeTabType == 'file'){<br>  s= editor.text;<br>  count= s.length - fileSize(tabs.activeFileName);   <br>  alert('Voc&ecirc; adicionou ' + count ' ao texto :)');<br>}<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">dirExists(dirname)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Retorna
true se o diret&oacute;rio passado como par&acirc;metro existir.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// lembre-se de usar o caracter de escape "\" para caminhos de arquivo<br>jsdk= dirExists('c:\\javasdk142\\');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">dirCopy(fromdir,
todir [, mask = '*' ][, overwrite = true])</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Copia
um diret&oacute;rio e seus subdiret&oacute;rios de "fromdir" para
"todir" de acordo com a mascara passada em "mask"; "mask" ("*" se
omitido) e "overwirte" ("true" se omitido) s&atilde;o opcionais. Um
di&aacute;logo ser&aacute; mostrado ao usu&aacute;rio enquanto a
c&oacute;pia &eacute; realizada indicando o progresso e permitindo que
ele cancele a opera&ccedil;&atilde;o se ela for muito longa. Se o
usu&aacute;rio cancelar ou ocorrerem erros, a fun&ccedil;&atilde;o
retornar&aacute; false. </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// faz um backup do diret&oacute;rio do Notes<br>dirCopy(getNotesDir(),getNotesDir() + 'backup\\');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">dirDelTree(dirname
[, mask = '*' ]) bool // deleta arquivos e
subdiret&oacute;rios. Use dirDelete para deletar o diret&oacute;rio
depois que ele estiver vazio </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Deleta
uma &aacute;rvore de diret&oacute;rios sem deletar o
diret&oacute;rio passado em "dirname". Voc&ecirc; pode usar a
fun&ccedil;&atilde;o para deletar apenas arquivos ou
subdiret&oacute;rios de um diret&oacute;rio usando uma m&aacute;scara.
Se voc&ecirc; quiser remover a pasta e todo o seu conte&uacute;do, use
dirDelTree('Nome do diret&oacute;rio') e depois dirDelete(' Nome do
diret&oacute;rio'). A m&aacute;scara &eacute; opcional e &eacute; "*"
quando omitida. Essa fun&ccedil;&atilde;o sempre funciona de forma
recursiva, mas voc&ecirc; pode impedi-la de deletar
subdiret&oacute;rios usando uma m&aacute;scara mais restritiva.
Alternativamente voc&ecirc; pode usar combina&ccedil;&otilde;es de
fileSearch com fileDelete e dirDelete para opera&ccedil;&otilde;es mais
complexas. Essa fun&ccedil;&atilde;o mostra um di&aacute;logo de
progresso ao usu&aacute;rio, como em dirCopy().<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// deleta todas as configura&ccedil;&otilde;es do Notes e sai do<br>// programa for&ccedil;ando o Notes a chamar o instalador <br>// da pr&oacute;xima vez que iniciar. (N&atilde;o fa&ccedil;a isto em casa!)<br>dirDelTree(getNotesSettingsDir());<br>notesExec('actFileExit');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">dirDelete(dirname)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Deleta
um diret&oacute;rio vazio.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>dirDelete(' Caminho aqui! ');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">dirCreate(dirname
[, force = false]) </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Cria
um novo diret&oacute;rio; "force" &eacute; par&acirc;metro opcinal
que &eacute; setado para false quando omitido. Se voc&ecirc; setar ele
para true a fun&ccedil;&atilde;o tentar&aacute; criar todos os
diret&oacute;rios necess&aacute;rios para poder criar o
diret&oacute;rio especificado.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Cria a pasta "Minha Pasta" no diret&oacute;rio do Notes<br>dirCreate( getNotesDir() + 'Minha Pasta\\' );<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">move(from,
to)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Move
um arquivo ou pasta do caminho especificado em "from" para "to".
Retorna true se funcionar.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>move( getNotesDir() + 'Minha Pasta', getNotesDir() + 'MyFolder'); <br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">rename(from,
to)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Renomeia
arquivo ou pasta. </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Tanto faz renomear ou mover :)<br>rename( getNotesDir() + 'Minha Pasta', getNotesDir() + 'MyFolder'); <br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<h3>2.6. Di&aacute;logos</h3>
Fun&ccedil;&otilde;es que permitem interargir com o usu&aacute;rio
mostrando di&aacute;lgos para pedir ou mostrar
informa&ccedil;&otilde;es.<br>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">alert(msg)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);"><span
 style="font-weight: bold;"></span>Mostra uma mensagem para o
usu&aacute;rio;<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// mostra di&aacute;logo com Hello Woooooorrrrrld! <br>alert('Hello Woooooorrrrrld!');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">msgDlg(msg)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">O
mesmo que alert();<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>//Mostra ol&aacute; <br>msgDlg('Ol&aacute;');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">confirmDlg(msg)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">&nbsp;Mostra
uma mensagem pedindo confirma&ccedil;&atilde;o ao usu&aacute;rio se
algo deve ou n&atilde;o ser feito. Retorna "yes, no, cancel".<span
 style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>if (confirmDlg('Deletar arquivo?') == 'yes') {<br>  //TODO c&oacute;digo para deletar arquivo aqui!<br>}<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">errorDlg(msg)</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">O
mesmo que alert e msgDlg, por&eacute;m com &iacute;cone de erro.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>errorDlg('Voc&ecirc; ainda n&atilde;o configurou o script usu&aacute;rio est&uacute;pido!');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">colorDlg()</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">&nbsp;Mostra
um di&aacute;logo para o usu&aacute;rio selecionar a cor e retorna a
cor no formato html (#RRGGBB). </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Insere uma cor no c&oacute;digo<br>editor.selText= colorDlg();<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">inputDlg(descr
[, value = '']) </span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">Di&aacute;logo
que
pede ao usu&aacute;rio que preencha um valor; "descr" especifica a
instru&ccedil;&atilde;o que ser&aacute; mostrada ao usu&aacute;rio;
"value" &eacute; um valor iniciar opcional. Retorna o valor preenchido
pelo usu&aacute;rio.<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>editor.selText= inputDlg('O que voc&ecirc; quer inserir hoje?!');<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">openDlg()</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">&nbsp;Mostra
um di&aacute;logo de abrir arquivo e permite o usu&aacute;rio escolher
um arquivo que ser&aacute; retornado como resultado da
fun&ccedil;&atilde;o.<span style="font-weight: bold;"> </span></td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>msgDlg("Voc&ecirc; selecionou " + openDlg());<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<table style="width: 90%; text-align: left;" border="0" cellpadding="2"
 cellspacing="2">
  <tbody>
    <tr>
      <td style="vertical-align: top;"><span style="font-weight: bold;">saveDlg()</span><br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(238, 238, 238);">O
mesmo que openDlg, s&oacute; que &eacute; mostrado um di&aacute;logo
de salvar.<br>
      </td>
    </tr>
    <tr>
      <td
 style="vertical-align: top; background-color: rgb(252, 255, 220);">Exemplo:<br>
      <pre>// Uma implementa&ccedil;&atilde;o de "salvar como" :)<br>s= saveDlg();<br>if (s != '') {<br>  filePutContents(s, editor.text);<br>}<br></pre>
      </td>
    </tr>
  </tbody>
</table>
<br>
<br>
<h2>3. A&ccedil;&otilde;es e propriedades internas do Notes<br>
</h2>
<h3>3.1. A&ccedil;&otilde;es do Notes</h3>
As a&ccedil;&otilde;es abaixo podem ser chamadas usando a
fun&ccedil;&atilde;o notesExec.<br>
<br>
<table style="width: 100%; text-align: left;" border="1" cellpadding="5"
 cellspacing="0">
  <tbody>
    <tr>
      <td width="30%">actFileNew</td>
      <td>Mostra o di&aacute;logo para criar novos arquivos</td>
    </tr>
    <tr>
      <td width="30%">actFileOpen</td>
      <td>Mostra o di&aacute;logo para abrir um arquivo</td>
    </tr>
    <tr>
      <td width="30%">actFileRevert</td>
      <td>Desfaz todas as altera&ccedil;&otilde;es revertendo o arquivo
para o seus estado inicial</td>
    </tr>
    <tr>
      <td width="30%">actFileSave</td>
      <td>Salva as modifica&ccedil;&otilde;es feitas no arquivo</td>
    </tr>
    <tr>
      <td width="30%">actFileSaveAs</td>
      <td>Mostra um di&aacute;logo que permite salvar o documento atual
com o nome que voc&ecirc; escolher</td>
    </tr>
    <tr>
      <td width="30%">actFileSaveAll</td>
      <td>Salva todos os arquivos</td>
    </tr>
    <tr>
      <td width="30%">actFileSaveSelection</td>
      <td>Mostra um di&aacute;logo que permite salvar o trecho
selecionado do documento</td>
    </tr>
    <tr>
      <td width="30%">actFilePrint</td>
      <td>Mostra um di&aacute;logo que permite imprimir o documento</td>
    </tr>
    <tr>
      <td width="30%">actFileClose</td>
      <td>Fecha o documento atual</td>
    </tr>
    <tr>
      <td width="30%">actFileCloseAll</td>
      <td>Fecha todos os documentos</td>
    </tr>
    <tr>
      <td width="30%">actFileExit</td>
      <td>Sai do programa</td>
    </tr>
    <tr>
      <td width="30%">actEditUndo</td>
      <td>Desfaz a &uacute;ltima altera&ccedil;&atilde;o feita</td>
    </tr>
    <tr>
      <td width="30%">actEditRedo</td>
      <td>Refaz a &uacute;ltima altera&ccedil;&atilde;o desfeita</td>
    </tr>
    <tr>
      <td width="30%">actEditCut</td>
      <td>Recorta o texto selecioado para a &aacute;rea de
transfer&ecirc;ncia</td>
    </tr>
    <tr>
      <td width="30%">actEditCopy</td>
      <td>Copia o texto selecioado para a &aacute;rea de
transfer&ecirc;ncia</td>
    </tr>
    <tr>
      <td width="30%">actEditPaste</td>
      <td>Cola o conte&uacute;do da &aacute;rea de transfer&ecirc;ncia
no documento</td>
    </tr>
    <tr>
      <td width="30%">actEditSmartPaste</td>
      <td>Cola o conte&uacute;do da &aacute;rea de transfer&ecirc;ncia
adequando esta a identa&ccedil;&atilde;o</td>
    </tr>
    <tr>
      <td width="30%">actEditAddToClipboard</td>
      <td>Adciona o texto selecionado ao conte&uacute;do da &aacute;rea
de transfer&ecirc;ncia</td>
    </tr>
    <tr>
      <td width="30%">actEditDel</td>
      <td>Deleta o texto selecionado ou o caracter atual</td>
    </tr>
    <tr>
      <td width="30%">actEditSelectAll</td>
      <td>Seleciona todo o texto</td>
    </tr>
    <tr>
      <td width="30%">actEditLineDel</td>
      <td>Deleta a linha atual</td>
    </tr>
    <tr>
      <td width="30%">actEditLineSelect</td>
      <td>Seleciona a linha atual</td>
    </tr>
    <tr>
      <td width="30%">actEditLineDuplicate</td>
      <td>Cria uma c&oacute;pia da linha atual</td>
    </tr>
    <tr>
      <td width="30%">actEditFormatUppercase</td>
      <td>Converte os caracteres selecionados ou a palavra atual para
mai&uacute;sculas</td>
    </tr>
    <tr>
      <td width="30%">actEditFormatLowercase</td>
      <td>Converte todos os caracteres ou a palavra atual para
min&uacute;sculas</td>
    </tr>
    <tr>
      <td width="30%">actEditFormatTitlecase</td>
      <td>Deixa todas as palavras com a primeira letra em
mai&uacute;scula</td>
    </tr>
    <tr>
      <td width="30%">actEditFormatToggleCase</td>
      <td>Transforma os caracteres mai&uacute;sculos para
min&uacute;sculas e vice-versa</td>
    </tr>
    <tr>
      <td width="30%">actEditComment</td>
      <td>Comenta as linhas selecionadas</td>
    </tr>
    <tr>
      <td width="30%">actEditUncomment</td>
      <td>Descomenta as linhas selecionadas</td>
    </tr>
    <tr>
      <td width="30%">actEditIndent</td>
      <td>Aumenta a identa&ccedil;&atilde;o das linhas selecionadas ou
da linha atual</td>
    </tr>
    <tr>
      <td width="30%">actEditUnindent</td>
      <td>Diminu&iacute; a identa&ccedil;&atilde;o das linhas
selecionadas ou da linha atual</td>
    </tr>
    <tr>
      <td width="30%">actSearchFind</td>
      <td>Mostra um di&aacute;logo que permite localizar no documento
atual e em outros documentos</td>
    </tr>
    <tr>
      <td width="30%">actSearchFindPrevius</td>
      <td>Localiza uma ocorr&ecirc;ncia anterior da palavra no texto</td>
    </tr>
    <tr>
      <td width="30%">actSearchFindNext</td>
      <td>Localiza a pr&oacute;xima ocorr&ecirc;ncia da palavra no texto</td>
    </tr>
    <tr>
      <td width="30%">actSearchReplace</td>
      <td>Mostra um di&aacute;logo quer permite substituir neste e em
outros documentos</td>
    </tr>
    <tr>
      <td width="30%">actSearchGotoline</td>
      <td>Mostra um di&aacute;logo que permite ir para uma linha exta
do documento</td>
    </tr>
    <tr>
      <td width="30%">actSearchGotocol</td>
      <td>Mostra um di&aacute;logo que permite ir para uma coluna exata
da linha atual</td>
    </tr>
    <tr>
      <td width="30%">actSearchToggleMark</td>
      <td>Adicionar ou remove um marcador &agrave; linha atual</td>
    </tr>
    <tr>
      <td width="30%">actSearchNextMark</td>
      <td>Pula para o pr&oacute;ximo marcador no texto</td>
    </tr>
    <tr>
      <td width="30%">actSearchPreviusMark</td>
      <td>Pula para o marcador anterior</td>
    </tr>
    <tr>
      <td width="30%">actSearchGotoMark</td>
      <td>Mostra um di&aacute;logo que permite pular para um dos
marcadores do arquivo</td>
    </tr>
    <tr>
      <td width="30%">actSearchClearMarks</td>
      <td>Deleta todos os marcadores</td>
    </tr>
    <tr>
      <td width="30%">actSearchNextProblem</td>
      <td>Pula para o pr&oacute;ximo problema</td>
    </tr>
    <tr>
      <td width="30%">actSearchPreviusProblem</td>
      <td>Pula para o problema anterior</td>
    </tr>
    <tr>
      <td width="30%">actSearchClearProblems</td>
      <td>Limpa a lista de problemas</td>
    </tr>
    <tr>
      <td width="30%">actSearchForward</td>
      <td>Avan&ccedil;a para um ponto em que voc&ecirc; j&aacute; esteve</td>
    </tr>
    <tr>
      <td width="30%">actSearchBack</td>
      <td>Volta para um ponto em que voc&ecirc; j&aacute; esteve</td>
    </tr>
    <tr>
      <td width="30%">actViewNexttab</td>
      <td>Mostra o pr&oacute;ximo documento</td>
    </tr>
    <tr>
      <td width="30%">actViewPreviustab</td>
      <td>Mostra o documento anterior</td>
    </tr>
    <tr>
      <td width="30%">actViewStatusBar</td>
      <td>Mostra/esconde a barra de status</td>
    </tr>
    <tr>
      <td width="30%">actViewToolbar</td>
      <td>Mostra/esconde a barra de ferramentas</td>
    </tr>
    <tr>
      <td width="30%">actProjectNew</td>
      <td>Mostra um di&aacute;logo que permite criar um novo projeto</td>
    </tr>
    <tr>
      <td width="30%">actProjectOpen</td>
      <td>Mostra um di&aacute;logo que permite abrir um documento do
projeto</td>
    </tr>
    <tr>
      <td width="30%">actProjectOpenAll</td>
      <td>Abre todos os documentos do projeto</td>
    </tr>
    <tr>
      <td width="30%">actProjectAdd</td>
      <td>Mostra um di&aacute;logo que permite adicionar um documento
ao projeto</td>
    </tr>
    <tr>
      <td width="30%">actProjectRemove</td>
      <td>Mostra um di&aacute;logo que permite remover um documento do
projeto</td>
    </tr>
    <tr>
      <td width="30%">actProjectOptions</td>
      <td>Mostra um di&aacute;logo que permite editar as
op&ccedil;&otilde;es do projeto</td>
    </tr>
    <tr>
      <td width="30%">actRunLast</td>
      <td>Executa o &uacute;ltimo item executado</td>
    </tr>
    <tr>
      <td width="30%">actRunFile</td>
      <td>Executa o arquivo atual</td>
    </tr>
    <tr>
      <td width="30%">actRunConfigure</td>
      <td>Mostra um di&aacute;logo que permite configurar as
ferramentas externas que podem ser executadas</td>
    </tr>
    <tr>
      <td width="30%">actCommandsUndo</td>
      <td>Desfaz todas as altera&ccedil;&otilde;es feitas pelo
&uacute;ltimo comando</td>
    </tr>
    <tr>
      <td width="30%">actCommandsFixlinebreaks</td>
      <td>Corrige as quebra de linhas do documento atual</td>
    </tr>
    <tr>
      <td width="30%">actCommandsWrap</td>
      <td>Mostra um di&aacute;logo que permite quebrar as linhas a cada
X caracteres</td>
    </tr>
    <tr>
      <td width="30%">actCommandsInsertFile</td>
      <td>Mostra um di&aacute;logo que permite inserir o
conte&uacute;do de um arquivo no documento atual</td>
    </tr>
    <tr>
      <td width="30%">actCommandsInsertDateTime</td>
      <td>Insere a data e hora atuais</td>
    </tr>
    <tr>
      <td width="30%">actCommandsInsertImage</td>
      <td>Mostra um di&aacute;logo que permite inserir a tag HTML para
mostrar a imagem selecionada</td>
    </tr>
    <tr>
      <td width="30%">actCommandsConvertSpecialHtmlChars</td>
      <td>Converte caracteres especiais para o seu c&oacute;digo HTML</td>
    </tr>
    <tr>
      <td width="30%">actCommandsCompressHtml</td>
      <td>Remove caracteres desnecess&aacute;rios do HTML diminuindo o
tamanho da sua webpage</td>
    </tr>
    <tr>
      <td width="30%">actCommandsVerifyHTML</td>
      <td>Verifica o c&oacute;digo HTML usando o HTMLTidy</td>
    </tr>
    <tr>
      <td width="30%">actCommandsFixHTML</td>
      <td>Tenta corrigir os erros do c&oacut...
 
[truncated message content]

[Notes2-team] =?ISO-8859-1?Q?Notes_com_suporte_a_Macros_em_JavaScr?= =?ISO-8859-1?Q?ipt!_Adeus_conc

[Notes2-team] =?ISO-8859-1?Q?Notes_com_suporte_a_Macros_em_JavaScr?= =?ISO-8859-1?Q?ipt!_Adeus_concorr=EAncia_=3A=29?=