4D Write - Linguagem

Transcrição

1 4D Write - Linguagem Introdução a 4D Write WR Folha de estilo WR Gestão de imagens WR Gestão de texto WR Opções da área WR Áreas WR Arrastar e soltar WR Controle da área WR Documentos WR Impressão WR Objetos dinâmicos WR Tabulações WR Utilitários Lista de temas de constantes Anexos Lista alfabética dos comandos

2 Introdução a 4D Write Introdução Gestão multiplataforma dos documentos Convenções de Escritura Comandos no editor de métodos Utilizar as áreas 4D Write Acessar aos menus de 4D Write Referenciar os caracteres

3 Introdução 4D Write é um plug-in que adiciona comandos de processamento de texto e funcionalidades a 4D. Com estes comandos, pode automatizar tarefas que normalmente se realizam de forma manual em um documento, tais como: Executar comandos de menu Abrir e salvar documentos Definir as margens de um documento Estabelecer os atributos de visualização. Todos os comandos de 4D Write estão precedidos pelas letras WR. Isto diferencia a estes comandos dos de 4D ou dos de qualquer outro plug-in. Documentação 4D Write A documentação disponível para 4D Write consta de dois manuais: o manual Usuário e o manual de Linguagem. O propósito deste manual, Linguagem, é descrever o uso da linguagem de programação de 4D Write. Para mais informação sobre como utilizar 4D Write, por favor consulte o manual Usuário de 4D Write.

4 Gestão multiplataforma dos documentos 4D Write, como 4D e 4D Server, é um programa multiplataforma. Portanto, uma base criada em Mac OS, e que utiliza 4D Write, pode ser executada em Windows sem modificações e vice-versa. Isto só é possível se utiliza as versões correspondentes do software. No entanto, a gestão de multiplataforma de bases 4D e de documentos 4D Write necessita ter em consideração certos princípios relacionados com as diferenças existentes entre Mac OS e Windows. Correspondência dos arquivos Mac OS e Windows A seguinte tabela indica os arquivos equivalentes de documentos 4D Write em Mac OS e Windows Documento Mac OS Type Creator Windows Extension Tipos virtuais (*) Documento 4D Write 4WR7 4DW7 4W7 4WR7 RTF TEXT 4DW7 RTF RTF Texto Windows TEXT 4DW7 TXT ASCW Texto Mac OS TEXT 4DW7 TXT ASCM Texto Unicode TEXT 4DW7 TXT ASCU Documento HTML TEXT MOSS HTML HTML Documento Word6/95 W6BN MSWD DOC DOC6 Word 97 PC/98 Mac W8BN MSWD DOC DOC8 (*) Estes tipos são utilizados pelos comandos WR OPEN DOCUMENT e WR SAVE DOCUMENT. Documentos As seguintes regras devem ser seguidas: Em Mac OS, 4D Write utiliza o tipo e o criador para reconhecer os documentos. Por exemplo, tipo 4WR7, criador 4DW7 = documento 4D Write. A via de acesso completa inclui o nome do disco, os nomes de pastas e o nome do documento, cada um separado por dois pontos (:). Por exemplo, MeuDisco:Pasta1:Pasta2:Minhabase. Em Windows, 4D Write utiliza a extensão de nome de arquivo para reconhecer os documentos. Por exemplo,.4w7 = documento 4D Write. A via de acesso completa inclui a letra do disco, os nomes de diretório e o nome do documento, cada um separado por uma barra invertida (\). Por exemplo, D:\Diretório1\Diretório2\Minhabase. Um documento 4D Write criado em Mac OS e copiado em Windows pode ser aberto diretamente, sempre que tenha sido salvo com sua extensão de arquivo. Por exemplo, o documento MeuDoc salvado como MeuDoc.4W7, copiado em um volumem de PC, pode ser aberto sem nenhuma outra manipulação. Um documento 4D Write criado em Windows e copiado a Mac OS ou Power Macintosh pode ser aberto sem nenhuma outra manipulação. Modelos Para compartilhar modelos entre clientes Mac OS e Windows, independentemente da plataforma do servidor, o procedimento é transparente para os usuários. O nome do arquivo de modelo será NomeÁrea_.4WT. Os modelos são salvados na pasta da base com 4D e 4D Server (se os modelos são salvados no servidor, que é a opção por padrão). Se, com 4D Server, você decidiu salvar os modelos de forma local (nas máquinas cliente) com o comando WR SET AREA PROPERTY, são salvados: Em Mac OS, na pasta Library:Application Support:4D:4D Write Templates:Nomebase Em Windows, na pasta Documents and settings\username\application data\4d\4d Write Templates\Nomebase

5 Convenções de Escritura Neste manual, os comandos 4D Write estão em maiúsculas e utilizam uma fonte especial, por exemplo: WR ON COMMAND. As funções 4D Write são mostradas com uma letra maiúscula inicial, por exemplo: WR Get styled text. Quando os comandos ou funções 4D Write aparecem nos métodos ou nos métodos objeto, se mostram em itálica negrita para diferenciá-los dos comandos e funções integradas de 4D. O texto en negrito não cursiva indica términos da linguagem 4D. QUERY([Templates];[Templates]ID=vNumber) ` Comando 4D If(Records in selection([templates])=1) WR PICTURE TO AREA(Area;[Templates]Doc) ` Comando 4D Write End if Em alguns exemplos deste manual, uma linha de código pode continuar em uma segunda ou terceira linha, devido a limitações de espaço. No entanto, ao escrever estes exemplos, conserve essas linhas de código em uma só linha, não pressione a tecla de retorno.

6 Comandos no editor de métodos Os comandos 4D Write podem ser mostrados em uma lista do editor de métodos de 4D. A lista pode conter unicamente os comandos de 4D Write ou todos os comandos de todos os plug-ins: Os comandos de plug-ins se agrupam por temas em forma de listas hierárquicas: Os comandos dos plug-ins também são mostrados na página Plug-ins do Explorador. Nota: As constantes dos plug-ins são adicionados a lista de constantes de 4D. Pode inserir um comando 4D Write em um método da mesma forma que faz com qualquer comando 4D: pode escrever diretamente no editor de métodos ou fazer duplo clique no nome do comando na lista. Pode utilizar um comando 4D Write em todo tipo de método: base, projeto, trigger, formulário ou objeto. Os comandos são úteis especialmente em métodos de objeto ativados por objetos no mesmo formulário como a área do documento.

7 Utilizar as áreas 4D Write Há três tipos de áreas disponíveis em 4D: Áreas 4D Write incluídas nos formulários Janelas externas 4D Write Áreas 4D Write fora da tela. Para utilizar um documento 4D Write, pode criar uma área de plug-in em um formulário ou abrir uma janela externa. Pode criar uma área externa, desenhando a área em um formulário no entorno Desenho. Uma janela externa é aberta, seja pela eleição de 4D Write no menu Ferramentas ou mediante a execução do comando Open external window. Além da criação de áreas visíveis, pode criar áreas invisíveis fora do monitor. Para obter mais informação, consulte o parágrafo "Áreas Fora da tela 4D Write", mais a frente nesta seção. Número de Identificação e variável da área 4D Write 4D Write utiliza variáveis para armazenar a localização das áreas 4D Write, janelas externas e áreas fora da tela. Para referenciar a área na que deseja realizar uma operação, deve passar a variável que contém o número de identificação da área como parâmetro para o comando ou a função. Nas descrições de comandos desta documentação, o parâmetro área se refere a variável de identificação da área do documento. Há dois tipos de variável area: Nomes dos objetos externos Quando cria e dá nome a uma área 4D Write, 4D reconhece automaticamente o nome da área 4D Write como uma variável que faz referencia a área. Por exemplo, você se referiria à área Carta especificando "Carta", como parâmetro área. As variáveis que você cria para uma janela externa ou uma área fora da tela Quando cria uma janela externa ou uma área fora da tela utilizando as funções Open external window ou WR New offscreen area, pode guardar o número de ID de área devolvido pela função em uma variável. A continuação, você pode utilizar a variável para fazer referencia a janela externa ou a área fora da tela em outros comandos e funções. Para guardar o valor em uma variável, localize o nome da variável e o operador de atribuição (:=) a esquerda da função na linha de código.. A maioria de comandos 4D Write requerem que se especifique uma área antes de que possam ser executados. Áreas de plug-in 4D Write Quando deseje que um documento 4D Write apareça em um formulário 4D, deve criar uma área plug-in no formulário e lhe atribuir um nome único, especificando o tipo de plug-in como 4D Write. 4D permite salvar este documento com o registro. Provavelmente você utiliza com mais frequência a área do plug-in para armazenar um documento ou para usá-lo no lugar de um campo de texto se o formato é importante. Janelas externas 4D Write 4D lhe permite criar um documento 4D Write em uma área independente chamada uma janela externa. As janelas externas são úteis quando deseja que o usuário tenha acesso a um processador de textos em qualquer momento para escrever cartas, memorandos e outros documentos. Executando a função 4D, Open external window, desde um método abre uma janela especificada e devolve um ID de área em uma variável inteiro. Pode fazer referência a esta variável cada vez que deseje executar um comando 4D Write para afetar a janela externa. Por exemplo: vwrite:=open external window(50;50;350;450;8;"merge Letter";"_4D Write") Para obter mais informação sobre o comando Open external window, consulte sua definição no Manual de linguagem 4D. Áreas 4D Write fora da tela

8 Uma área fora da tela se armazena na memória e não é visível para o programador ou para o usuário. Pode utilizar uma área fora da tela para modificar um documento antes que um usuário o veja ou para guardar o documento para que o usuário possa voltar ao original, se é necessário. WR New offscreen area e WR PICTURE TO AREA são os dois comandos que se utilizam para criar uma área fora da tela. Lembre que deve eliminar a área fora da tela depois de ter terminado de utilizar para liberar a memória que utiliza. Quando se põe em um método global, o seguinte código cria uma área fora da tela para guardar o documento. QUERY([Empregados];[Empregados]ID=vID) If(Records in selection([empregados]=1) Area:=WR New offscreen area WR PICTURE TO AREA(Area;[Empregados]Review_) `Guardar review na área fora da tela MODIFY RECORD([Empregados]) `Modificar o registro empregados WR DELETE OFFSCREEN AREA(Area) `Liberar a memória utilizada pela área fora de tela End if Utilizando um botão em um formulário, pode permitir ao usuário voltar ao documento original guardado. Pode criar um botão no formulário de entrada e lhe atribui o seguinte código: Review:=WR Area to picture(area) `Põe a área fora da tela que contém o documento original na área externa `contida no formulário Review.

9 Acessar aos menus de 4D Write Pode acessar por programação aos menus de 4D Write e selecionar os comandos de menus. Em um método, pode determinar o estado de um menu ou de um comando de menu. Cada comando de menu é referenciado por um número inteiro único. Ver o Anexo B: Códigos dos comandos de menus. Os códigos dos comandos de menus são baseados geralmente na localização do menu e do comando. Os menus estão numerados de esquerda a direita em ordem ascendente. Por exemplo, Arquivo = 100 e Edição = 200. Do mesmo modo, os elementos de menu se numeram em ordem ascendente de encima a abaixo. Os números dos comandos de menu definidos no Anexo B não variam, inclusive em futuras versões de 4D Write que possam ter novos elementos de menu. Os novos comandos de menus usam números diferentes, inclusive se colocam entre os elementos do menu atual. Esta posição invalida a regra geral da numeração dos comandos de menus, mas as referências de menu que utiliza nos métodos seguirão precisas, assim que não terá que atualizar.

10 Referenciar os caracteres Um caractere em um documento é referenciado por seu número sequencial. Os comandos que referenciam aos caracteres permitem especificar um só caractere ou um rango de caracteres. Por exemplo, pode selecionar por programação uma palavra, uma frase, ou um parágrafo inteiro. Utilize o comando WR GET SELECTION para determinar as posições dos caracteres selecionados em uma área 4D Write. O comando utiliza os parâmetros $Primeiro e $Ultimo para se referir ao intervalo de caracteres selecionados. O parâmetro $Primeiro sempre designa o caractere localizado justo antes do primeiro caractere selecionado. O parâmetro $Ultimo é igual ao último caractere selecionado. Exemplo Por exemplo, a seguinte expressão devolve as coordenadas do texto selecionado em Área nas variáveis $Primeiro e $Ultimo: WR GET SELECTION(Area;$Primero;$Ultimo) Para selecionar texto em uma área 4D Write, deve referenciar os caracteres. Na maioria dos casos, primeiro deve selecionar o texto antes de lhe aplicar um comando.

11 WR Folha de estilo Folha de estilo, Introdução WR ADD STYLESHEET TAB WR APPLY STYLESHEET WR Create stylesheet WR DELETE STYLESHEET WR DELETE STYLESHEET TAB WR Get stylesheet font WR GET STYLESHEET INFO WR GET STYLESHEET TAB WR Get stylesheet text prop WR SET STYLESHEET FONT WR SET STYLESHEET INFO WR SET STYLESHEET TAB WR SET STYLESHEET TEXT PROP WR UPDATE STYLESHEET

12 Folha de estilo, Introdução Os comandos e funções deste tema permitem controlar as folhas de estilo associadas a uma área de texto 4D Write. Pode recuperar a folha de estilo atual ou aplicar uma diferente. Isto lhe permite controlar as propriedades de formato tais como tabulações, negrito, itálico ou tamanho da fonte. Também pode apagar uma folha de estilo existente.

13 WR ADD STYLESHEET TAB WR ADD STYLESHEET TAB ( area ; numfolha ; posicao ; justificaçao ; caractercond ) area Área 4D Write numfolha Número da folha de estilo posicao Localização da tabulação justificaçao Valor de justificação da tabulação caractercond cadeia Caractere de enchimento selecionado O comando WR ADD STYLESHEET TAB permite adicionar uma nova tabulação a lista de tabulações na folha de estilo designada por numfolha. Usando o comando WR ADD STYLESHEET TAB, pode estabelecer a posição de tabulação, seu tipo e seu caractere de preencher. Se já existe uma tabulação em posicao, será substituída pela nova tabulação. Nota: Os textos que utilizam a folha de estilo que deseja modificar não se atualizarão a não ser que chame ao comando WR UPDATE STYLESHEET para atualizar o texto que utiliza a folha de estilos. posicao é a distância desde a margem esquerda (expressada em unidades por padrão do documento). O parâmetro opcional justificacao determina o tipo de tabulação. Pode utilizar as seguintes constantes, que se encontram no tema "WR Tabs": Constante Tipo Valor wr left tab 1 wr centered tab 2 wr right tab 3 wr decimal tab 4 wr vertical separator tab 5 Se a justificacao é omitida, é criada uma tabulação alinhada a esquerda. O parâmetro opcional caractercond pode ser qualquer caractere cujo código esteja entre 33 e 127. Este caractere será adicionado utilizando a mesma fonte da tabulação. Se caractercond se omite ou é passada uma cadeia vazia, não será introduzido caractere de preenchimento. Exemplo Ver o exemplo do comando WR UPDATE STYLESHEET.

14 WR APPLY STYLESHEET WR APPLY STYLESHEET ( area ; numfolha ) area Área 4D Write numfolha Número da folha de estilo O comando WR APPLY STYLESHEET aplica a seleção atual a folha de estilo cujo número é passado em numfolha. Os formatos da folha de estilo se aplicam a seleção e a seleção aparecerá como utilizando essa folha de estilo (quando o cursor esteja no texto, a interface mostrará que este texto está nesse estilo). Se numfolha não corresponde a nenhuma folha de estilo, se devolve o erro 1078 (folha de estilo desconhecida). Exemplo Ver o exemplo do comando WR Create stylesheet.

15 WR Create stylesheet WR Create stylesheet ( area ; nome ; aplicara ; atalho ) -> Resultado area Área 4D Write nome cadeia Nome da folha de estilo aplicara 0=caracteres 1=parágrafos atalho cadeia Um caractere Resultado Número da folha de estilo O comando WR Create stylesheet cria uma nova folha de estilos e devolve o número que lhe foi atribuído. As características da nova folha de estilos são fixadas pelos parâmetros nome, aplicara e atalho. Pode modificar a folha de estilo utilizando os comandos WR SET STYLESHEET TEXT PROP, WR SET STYLESHEET FONT, WR SET STYLESHEET TAB e o número de referencia de folha de estilos. nome: O nome de uma folha de estilo não deve exceder os 31 caracteres. No parâmetro aplicara, pode passar uma das seguintes constantes, que se encontram no tema WR Parameters: Constante Tipo Valor wr apply to characters 0 wr apply to paragraphs 1 Quando se aplica aos parágrafos, começa com o primeiro parágrafo em sua seleção e se aplica até o final do último parágrafo desta seleção. Se omitido aplicara, a folha de estilo será aplicado aos caracteres. O parâmetro opcional atalho permite atribuir um atalho do teclado à folha de estilos. Só aceita um caractere. Para utilizar o atalho terá que pressionar a tecla passada neste parâmetro com a tecla Ctrl (em Windows) ou a tecla Comando (Mac OS). Se recomenda utilizar um número com o propósito de evitar todo conflito com os atalhos de teclado padrão de 4D Write. Se é omitido atalho ou se trata de uma cadeia vazia, nenhum atalho será atribuído a folha de estilos. Exemplo Você quer adicionar a cada documento sua própria folha de estilo de caracteres personalizados e aplicar ela a seleção. A folha de estilo se atribui ao atalho Comando+1 em Mac OS e Ctrl+1 em Windows. A fonte utilizada é Comic Sans MS 12 pontos. $NumSheet:=WR Create stylesheet(area;"myownstyle";wr apply to characters;"1") WR SET STYLESHEET FONT(Area;$NumSheet;"Comic Sans MS") WR SET STYLESHEET TEXT PROP(Area;$NumSheet;wr font size;12;1) WR EXECUTE COMMAND(Area;wr cmd select all) WR APPLY STYLESHEET(Area;$NumSheet)

16 WR DELETE STYLESHEET WR DELETE STYLESHEET ( area ; numfolha ) area Área 4D Write numfolha Número da folha de estilo O comando WR DELETE STYLESHEET apaga a folha de estilo cujo número é passado em numfolha da área 4D Write referenciada por area. Atenção: As folhas de estilo do sistema não podem ser apagadas. Pode utilizar o comando WR GET STYLESHEET INFO para determinar se a folha de estilo está protegida. Exemplo Você quer apagar todas as folhas de estilo não protegidas em seu documento: C_LONGINT(Area) C_INTEGER(NbStyleSheet;$SheetNum) `Contagem do número de folhas de estilo NbStyleSheet:=WR Count(Area;wr nb stylesheets) $SheetNum:=1 For($i;1;NbStyleSheet) WR GET STYLESHEET INFO(Area;$SheetNum;$Name;$ApplyTo;$Protected;$Shortcut) If($Protected=0) `Se a folha de estilo não está protegida... WR DELETE STYLESHEET(Area;$SheetNum) Else $SheetNum:=$SheetNum+1 End if End for

17 WR DELETE STYLESHEET TAB WR DELETE STYLESHEET TAB ( area ; numfolha ; numtab ) area Área 4D Write numfolha Número da folha de estilo numtab Numero da tabulação a eliminar O comando WR DELETE STYLESHEET TAB elimina a tabulação, cujo número é passado em numtab da folha de estilo numfolha, na área 4D Write referenciada por area. As folhas de estilo são numeradas de cima para baixo, como se lista na caixa de diálogo de folhas de estilo. Este comando não tem efeito no texto selecionado, ainda que utilize atualmente a folha de estilo numfolha. Para atualizar o texto que utiliza a folha de estilo modificada, é necessário utilizar o comando WR UPDATE STYLESHEET. Exemplo Ver o exemplo do comando WR UPDATE STYLESHEET.

18 WR Get stylesheet font WR Get stylesheet font ( area ; numfolha ) -> Resultado area Área 4D Write numfolha Número da folha de estilo Resultado cadeia Nome da fonte, ou "" se a fonte não está definida O comando WR Get stylesheet font devolve o nome da fonte atribuída a folha de estilo cujo número é passado em numfolha na área 4D Write referenciada por area. As folhas de estilo são numeradas de cima para baixo como é visto no diálogo de folhas de estilo. Se nenhuma fonte foi definida para esta folha de estilo, é retornada uma cadeia vazia. Exemplo Você quer excluir o atributo "Fonte" de cada folha de estilo onde se utiliza e onde a fonte não esteja instalada no sistema: ARRAY STRING(80;FontsArray) WR FONTS TO ARRAY(FontsArray) $StyleSheetNum:=WR Count(Area;wr nb stylesheets) For($i;1;$StyleSheetNum) $Fonts:=WR Get stylesheet font(area;$i) If(($Fonts#"")&(Find in array(area;$fonts)=0)) WR SET STYLESHEET FONT(Area;$i;"") End if End for

19 WR GET STYLESHEET INFO WR GET STYLESHEET INFO ( area ; numfolha ; nome ; aplicara ; protegido ; atalho ) area Área 4D Write numfolha Número da folha de estilo nome cadeia Nome da folha de estilo aplicara 0=caracteres, 1=parágrafos protegido 0= não protegido, 1= protegido atalho cadeia Um caractere ou "" se não há atalho O comando WR GET STYLESHEET INFO permite recuperar a informação sobre a folha de estilo cujo número é passado em numfolha e que se encontra na área 4D Write referenciada por area. nome devolve o título da folha de estilo. aplicara: protegido: Se aplicara é igual a 0, a folha de estilo só se aplica aos caracteres. Se aplicara é igual a 1, a folha de estilo só se aplica aos parágrafos. Se protegido é igual a 0, a folha de estilos não está protegida, portanto não é uma folha de estilo do sistema. Se protegido é igual a 1, a folha de estilos está protegida, portanto é uma folha de estilo do sistema e não pode ser excluída. atalho permite saber se existe um equivalente de teclado associado à folha de estilo. Está formado por somente um caractere. Ao utilizar esse atalho terá que manter pressionada a tecla Ctrl (em Windows) ou a tecla Comando (em Mac OS). Se atalho é uma cadeia vazia, nenhum atalho está associado à numfolha. Exemplo Ver os exemplos dos comandos WR SET STYLESHEET INFO, WR DELETE STYLESHEET e WR UPDATE STYLESHEET.

20 WR GET STYLESHEET TAB WR GET STYLESHEET TAB ( area ; numfolha ; numtab ; posicao ; justificaçao ; caractercond ) area Área 4D Write numfolha Número da folha de estilo numtab Número de tabulação posicao Posição da tabulação justificaçao Valor de alinhamento da tabulação caractercond cadeia Caractere de condução escolhido O comando WR GET STYLESHEET TAB permite recuperar os parâmetros da tabulação, de número numtab e que pertence a folha de estilo numfolha na área 4D Write referencia por area. Para conhecer o número de tabulações da folha de estilo, pode utilizar: WR GET STYLESHEET INFO (area;numfolha;wr tab;aplicara), que devolve o número de tabulações. posicao é a distância desde a margem esquerda do documento a tabulação, expressada nas unidades por padrão atuais do documento. alinhamento é o tipo de alinhamento da tabulação: Valor Alinhamento 1 Alinhamento a esquerda 2 Centrada 3 Alinhamento a direita 4 Decimal 5 Separador vertical caractercond pode ser qualquer caractere cujo código esteja entre 33 e 127. Se caractercond é uma cadeia vazia, então não há nenhum caractere de preenchimento na tabulação. Exemplo Você quer mudar os caracteres de enchimento para cada folha de estilo e depois atualizar seu documento. $StyleSheetNum:=WR Count(Area;wr nb stylesheets) For($i;1;$StyleSheetNum) $TabNum:=WR Get stylesheet text prop(area;$i;wr tab;$apply) If($TabNum#0) For($j;1;$TabNum) WR GET STYLESHEET TAB(Area;$i;$j;$Pos;$Justif;$FillChar) If($FillChar#"") WR SET STYLESHEET TAB(Area;$i;$j;$Pos;$Justif;Char(126)) End if End for WR UPDATE STYLESHEET(Area;$i) End if End for

21 WR Get stylesheet text prop WR Get stylesheet text prop ( area ; numfolha ; propriedade ; aplicara ) -> Resultado area Área 4D Write numfolha Número da folha de estilo propriedade Número da propriedade de texto a ler aplicara Resultado Real Depende do parâmetro da propriedade O comando WR Get stylesheet text prop permite saber, por área, se a propriedade se aplica a seleção. Se propriedade = 7 (constante wr font number), o valor devolvido é um número interno. 4D Write atribui os números de fonte sequencialmente a medida que se utilizem. Este número só pode ser utilizado pelo comando WR SET STYLESHEET TEXT PROP. Recomenda-se utilizar os comandos WR Get stylesheet font e WR SET STYLESHEET FONT que trabalham com os nomes de fontes. A propriedade 15 (constante wr stylesheet number) não tem nenhum significado para esta função. Se propriedade = 64 (constante wr tab), WR Get stylesheet text prop devolve o número de tabulações definido para a folha de estilos. Para as propriedades de cor, o valor devolvido tem o seguinte formato (como em 4D e na versão anterior de 4D Write): 0x00RRGGBB. Para separar os valores RGB, utilize o comando WR COLOR TO RGB. Si -1 se devolve para as propriedades 11(constante wr strikethrough color), 12 (constante wr underline color), ou 13 (constante wr shadow color), estes elementos são da mesma cor que o texto. Se devolver -1 para a propriedade 10 (constante wr text back color), não há cor de fundo selecionado para o texto. Nota: Propriedade pode ser definida utilizando constantes. A lista das propriedades de texto e sua referencia está disponível no tema "WR Text properties". Pode passar o valor ou a constante. Se aplicara é igual a 1, a folha de estilo leva em conta a propriedade. Se aplicara é igual a 0, a folha de estilo não tem em conta a propriedade. Exemplo Ver os exemplos dos comandos WR UPDATE STYLESHEET, WR GET STYLESHEET TAB.

22 WR SET STYLESHEET FONT WR SET STYLESHEET FONT ( area ; numfolha ; fonte ) area Área 4D Write numfolha Número da folha de estilo fonte Alfa Nome da fonte O comando WR SET STYLESHEET FONT permite modificar a fonte do caractere para a folha de estilo cujo número é passado em numfolha no documento 4D Write referenciado por area. Passe em fonte o nome da fonte a aplicar. Se desejar aplicar a folha de estilo à seleção, passe uma cadeia vazia em fonte. Se fonte não está instalada no sistema, se devolve o erro 1077 (Fonte não disponível no sistema). Exemplo Ver o exemplo do comando WR SET STYLESHEET INFO.

23 WR SET STYLESHEET INFO WR SET STYLESHEET INFO ( area ; numfolha ; name ; aplicara ; atalho ) area Área 4D Write numfolha Número da folha de estilo name Alfa Nome da folha de estilo aplicara 0=caracteres 1=parágrafos atalho Alfa um caractere "" se não há atalho O comando WR SET STYLESHEET INFO permite modificar as propriedades da folha de estilo cujo número de referencia é passado em numfolha e que aparece em area. O número de folha de estilo corresponde a ordem de surgimento da folha de estilo quando é mostrado na lista abaixo de folhas de estilo ou na lista na caixa de diálogo Folhas de estilo. nome: Se nome é uma cadeia vazia, o nome original da folha de estilos não será modificado. O nome de uma folha de estilo não deve exceder os 31 caracteres. Atenção: Duas folhas de estilo podem ter o mesmo nome, no entanto, sempre têm diferentes números de referencia. aplicara: Se aplicara é igual a -1, o valor atual seguirá sendo o mesmo. Também pode passar uma das seguintes constantes, que se encontram no tema WR Parameters: Constante Tipo Valor wr apply to characters 0 wr apply to paragraphs 1 Uma folha de estilo de parágrafo sempre se aplica a todos os parágrafos da seleção, ainda que o primeiro e último parágrafo esteja parcialmente selecionados. Por padrão, uma nova folha de estilo se aplica aos caracteres. atalho: O parâmetro opcional atalho permite atribuir um atalho do teclado a folha de estilos. Só aceita um caractere. Para utilizar o atalho terá que pressionar a tecla passada neste parâmetro com a tecla Ctrl (em Windows) ou a tecla Comando (Mac OS). Se recomenda utilizar um número com o propósito de evitar todo conflito com os atalhos de teclado padrão de 4D Write. Se omitido atalho ou se tratada de uma cadeia vazia, nenhum atalho será atribuído a folha de estilos. numfolha: Se deseja que o número de folha de estilos permaneça idêntico, é necessário chamar ao comando WR GET STYLESHEET INFO utilizar o número de referencia devolvido por esse comando. Exemplo Você quer modificar a definição da folha de estilo Title : seu nome muda a Title 14, sua fonte se define em Times 14 com negrito e cor azul. NbStyles:=WR Count(Area;12) For($i;1;NbStyles) WR GET STYLESHEET INFO(Area;$i;$Name;$ApplyTo;$Protected;$Shortcut) If($Name="Title") WR SET STYLESHEET INFO(Area;$i;"Title 14";$ApplyTo;$Shortcut) WR SET STYLESHEET FONT(Area;$i;"Times") WR SET STYLESHEET TEXT PROP(Area;$i;wr font size;14;1) WR SET STYLESHEET TEXT PROP(Area;$i;wr bold;1;1) WR SET STYLESHEET TEXT PROP(Area;$i;wr text color;212;1) End if End for

24 WR SET STYLESHEET TAB WR SET STYLESHEET TAB ( area ; numfolha ; numtab ; posicao ; alinhamento ; carpreen ) area Área 4D Write numfolha Número da folha de estilo numtab Número da tabulação posicao Nova posição da tabulação alinhamento Novo valor de alinhamento da tabulação carpreen cadeia Caractere de preenchimento selecionado O comando WR SET STYLESHEET TAB permite modificar os parâmetros da tabulação, cujo número passou em numtab (as tabulações se contam de esquerda a direita) que pertencem à folha de estilo cujo número passou em numfolha (as folhas de estilo se contam de cima para baixo como se mostrado na caixa de diálogo de folhas de estilo). O comando WR SET STYLESHEET TAB move a tabulação até a posicao e define o tipo do caractere de preenchimento, assim como sua justificação. Este comando não tem efeito no texto selecionado, inclusive se utiliza a folha de estilo que está sendo modificada. Se desejar atualizar o texto que utiliza a folha de estilo, chame ao comando WR UPDATE STYLESHEET depois de modificar a definição de folha de estilos. Se desejar aplicar imediatamente as propriedades da nova tabulação da folha de estilo tanto a folha de estilo como a seleção atual, utilize o comando WR APPLY STYLESHEET. Se uma tabulação já existe na nova localização na folha de estilo, será substituída pela tabulação que acaba de modificar. posicao é a distancia desde a margem esquerda até onde deseja mover a tabulação. posicao se expressa na unidade atual por padrão para o documento. Se não quer mudar a posição da tabulação, passe -1 no parâmetro posicao. alinhamento especifica o tipo de alinhamento para a tabulação. Para não modificar o alinhamento da tabulação, passe -1 neste parâmetro. Caso contrário, pode utilizar as seguintes constantes, que se encontram no tema "WR Tabs": Constante Tipo Valor wr left tab 1 wr centered tab 2 wr right tab 3 wr decimal tab 4 wr vertical separator tab 5 carpreen pode ser qualquer caractere cujo código esteja entre 33 e 127. Este caractere se mostra na mesma fonte que a tabulação modificada. Exemplo Ver o exemplo do comando WR GET STYLESHEET TAB.