Objetos JavaScript do Acrobat com suporte no Designer

A tabela a seguir lista a disponibilidade dos objetos, das propriedades e dos métodos do Acrobat usados com mais frequência no Designer e fornece informações sobre qualquer funcionalidade equivalente no Designer. Embora a tabela contenha os objetos, as propriedades e os métodos usados com mais frequência no Acrobat, alguns não estão listados, como os objetos multimídia, porque são raramente usados para os formulários.

Quando não houver nenhuma funcionalidade equivalente do Designer listada, nenhuma propriedade ou método direto do Designer poderá reproduzir o comportamento do Acrobat. No entanto, ainda é possível criar funções ou scripts personalizados para copiar o recurso do Acrobat.

JavaScript no Acrobat

Suporte ao Designer

Equivalente do JavaScript no Designer

Comentários

Propriedades e métodos do objeto Annot

Todas as propriedades e métodos

Sim

Nenhum

Apenas os formulários com um layout fixo suportam a camada de anotação.

Propriedades do objeto app

calculate

Não

Nenhum

O Designer inclui o método execCalculate que inicia o evento calculate.

execCalculate

language

Sim

xfa.host.language

Consulte a propriedade language.

language

monitors

Sim

Nenhum

 

platform

Sim

xfa.host.platform

Consulte a propriedade platform.

platform

plugins

Sim

Nenhum

 

toolbar

Sim

Nenhum

 

viewerType

Sim

xfa.host.appType

Consulte a propriedade appType.

appType

viewerVariation

Sim

xfa.host.variation

Consulte a propriedade variation.

variation

viewerVersion

Sim

xfa.host.version

Consulte a propriedade version.

version

Métodos do objeto app

addMenuItem

Sim

Nenhum

 

addSubMenu

Sim

Nenhum

 

addToolButton

Sim

Nenhum

 

alert

Sim

xfa.host.messageBox()

Consulte o método messageBox.

messageBox

beep

Sim

xfa.host.beep()

Consulte o método beep.

beep

browseForDoc

Sim

Nenhum

 

clearInterval

Sim

Nenhum

 

clearTimeOut

Sim

Nenhum

 

execDialog

Sim

Nenhum

 

execMenuItem

Sim

Nenhum

Executa o comando de menu especificado. Use este método no Designer para os comandos do menu Arquivo.

getNthPluginName

Sim

Nenhum

 

getPath

Sim

Nenhum

 

goBack

Sim

Nenhum

 

goForward

Sim

Nenhum

 

hideMenuItem

Sim

Nenhum

 

hideToolbarButton

Sim

Nenhum

 

launchURL

Sim

Nenhum

O Designer inclui o método gotoURL que carrega um URL específico no aplicativo cliente, como Acrobat ou Adobe Reader.

gotoURL

listMenuItems

Sim

Nenhum

 

listToolbarButtons

Sim

Nenhum

 

mailGetAddrs

Sim

Nenhum

 

mailMsg

Sim

Nenhum

 

newDoc

Sim

Nenhum

Este método pode ser executado somente durante os eventos de lote, console ou menu.

newFDF

Não

Nenhum

 

openDoc

Sim

Nenhum

 

openFDF

Não

Nenhum

 

popUpMenuEx

Sim

Nenhum

 

popUpMenu

Sim

Nenhum

 

removeToolButton

Sim

Nenhum

 

response

Sim

xfa.host.response()

Consulte o método response.

response

setInterval

Sim

Nenhum

 

setTimeOut

Sim

Nenhum

 

trustedFunction

Sim

Nenhum

 

trustPropagatorFunction

Sim

Nenhum

Este método só está disponível durante a inicialização do lote, do console e do aplicativo.

Propriedades e métodos do objeto de marcador

Todas as propriedades e métodos

Sim

Nenhum

 

Propriedades do objeto doc

author

Sim

Nenhum

 

baseURL

Sim

Nenhum

 

bookmarkRoot

Sim

Nenhum

 

calculate

Não

Nenhum

 

dataObjects

Sim

Nenhum

 

delay

Não

Nenhum

 

dirty

Sim

Nenhum

Este script JavaScript para Designer salva uma cópia de um formulário e testa se o formulário foi alterado:

var sOrigXML = xfa.data.saveXML; if (sOrigXML != xfa.data.saveXML) {...}

disclosed

Sim

Nenhum

 

documentFileName

Sim

Nenhum

 

dynamicXFAForm

Sim

Nenhum

 

external

Sim

Nenhum

 

filesize

Sim

Nenhum

 

hidden

Sim

Nenhum

 

icons

Sim

Nenhum

 

keywords

Sim

Nenhum

 

layout

Sim

Nenhum

 

media

Sim

Nenhum

 

metadata

Sim

xfa.form.desc

Consulte o objeto desc .

desc

modDate

Sim

Nenhum

 

mouseX mouseY

Sim

Nenhum

 

noautocomplete

Sim

Nenhum

 

nocache

Sim

Nenhum

 

numFields

Sim

xfa.layout.pageContent()

O método pageContent retorna uma lista de todos os objetos de um determinado tipo. Entretanto, você deve executar o método para exibições de projeto e páginas mestras para ler o formulário inteiro.

pageContent

numPages

Sim

xfa.host.numPages

ou

xfa.layout.absPageCount() xfa.layout.pageCount()

A propriedade numPages retorna a contagem de páginas para o formulário renderizado no cliente. Consulte também os métodos absPageCount e pageCount.

numPages

absPageCount

pageCount

pageNum

Sim

xfa.host.currentPage

Consulte a propriedade currentPage.

currentPage

pageNum--

Sim

xfa.host.currentPage--

ou

xfa.host.pageUp()

Consulte a propriedade currentPage ou o método pageUp.

currentPage

pageUp

pageNum++

Sim

xfa.host.currentPage++

ou

xfa.host.pageDown()

Consulte a propriedade currentPage ou o método pageDown.

currentPage

pageDown

path

Sim

Nenhum

 

securityHandler

Sim

Nenhum

 

templates

Não

Nenhum

Use objetos de subformulário no Designer e use as propriedades e os métodos para adicionar, remover, mover e definir instâncias de subformulário.

Adicione e remova instâncias de subformulário usando scripts

title

Sim

xfa.host.title

Consulte a propriedade title.

Método do objeto doc

addAnnot

Sim

Nenhum

 

addField

Não

Nenhum

Você deve usar formulários com um layout fixo no Designer e, em seguida, usar o objeto instanceManager para adicionar, remover e definir o número de instâncias de determinado objeto.

instanceManager

Para obter mais informações, consulte Adicionar e remover instâncias de subformulário usando scripts.

addIcon

Sim

Nenhum

 

addLink

Não

Nenhum

 

addRecipientListCryptFilter

Sim

Nenhum

 

addScript

Sim

Nenhum

 

addThumbnails

Não

Nenhum

 

addWatermarkFromFile

Sim

Nenhum

 

addWatermarkFromText

Sim

Nenhum

 

addWeblinks

Sim

Nenhum

 

appRightsSign

Sim

Nenhum

 

appRightsValidate

Sim

Nenhum

 

bringToFront

Sim

Nenhum

 

calculateNow

Não

xfa.form.recalculate(1);

ou

execCalculate()

recalculate

O método recalculate força o início de um conjunto de scripts específico nos eventos calculate . O valor booliano indica True (padrão) - todos os scripts de cálculo são iniciados; ou False - apenas o script de cálculo pendente é iniciado.

O objeto calculate do Designer controla se um usuário pode substituir um valor calculado do campo.

execCalculate

Se preferir, você pode usar o método execCalculate para cada objeto para o qual você deseja forçar um recálculo.

closeDoc

Sim

Nenhum

 

createDataObject

Sim

Nenhum

 

createTemplate

Não

Nenhum

Os formulários Designer não têm um equivalente ao conceito de um modelo Acrobat. É necessário usar objetos de subformulário no Designer.

deletePages

Não

Nenhum

instanceManager

No Designer, você pode usar o objeto instanceManager para remover o objeto de subformulário que representa uma página de seu formulário.

Para obter mais informações, consulte Adicionar e remover instâncias de subformulário usando scripts.

embedDocAsDataObject

Sim

Nenhum

 

encryptForRecipients

Sim

Nenhum

 

encryptUsingPolicy

Sim

Nenhum

 

exportAsText

Sim

Nenhum

Este método só está disponível no console JavaScript do depurador JavaScript no Acrobat ou durante o processamento do lote.

exportAsFDF

Não

xfa.host.exportData()

exportData

O método exportData exporta um arquivo XML ou XDP em vez de um arquivo FDF.

exportAsXFDF

Não

xfa.host.exportData()

exportData

O método exportData exporta um arquivo XML ou XDP em vez de um arquivo FDF.

exportDataObject

Sim

Nenhum

 

exportXFAData

Não

xfa.host.exportData()

exportData

O método exportData exporta um arquivo XML ou XDP em vez de um arquivo FDF.

extractPages

Não

Nenhum

 

flattenPages

Não

Nenhum

 

getAnnot

Sim

Nenhum

 

getAnnots

Sim

Nenhum

 

getDataObjectContents

Sim

Nenhum

 

getField("FieldName")

Sim

xfa.resolveNode ("FieldName")

resolveNode

O método resolveNode acessa o objeto especificado no XML de origem do formulário.

getLegalWarnings

Sim

Nenhum

 

getLinks

Não

Nenhum

 

getNthFieldName

Sim

É necessário executar um loop por todos os objetos com um nome de classe similar até atingir a ocorrência nth.

className

Consulte a propriedade className.

getNthTemplate

Não

Nenhum

 

getOCGs

Sim

Nenhum

 

getOCGOrder

Sim

Nenhum

 

getPageBox

Sim

Nenhum

 

getPageLabel

Sim

Nenhum

 

getPageNthWord

Sim

Nenhum

 

getPageNthWordQuads

Sim

Nenhum

 

getPageNumWords

Sim

Nenhum

 

getPageRotation

Sim

Nenhum

 

getPrintParams

Sim

Nenhum

 

getTemplate

Não

Nenhum

 

getURL

Sim

xfa.host.gotoURL( "http://www.adobe.com");

Consulte o método gotoURL.

gotoURL

 

gotoNamedDest

Não

Nenhum

 

importAnFDF

Não

Nenhum

 

importAnXFDF

Sim

Nenhum

 

importDataObject

Sim

Nenhum

 

importIcon

Sim

Nenhum

 

importTextData

Sim

Nenhum

 

importXFAData

Não

xfa.host.importData ("filename.xdp");

Consulte o método importData.

importData

insertPages

Não

Nenhum

 

mailDoc

Sim

Nenhum

 

mailForm

Não

Nenhum

 

movePage

Não

Nenhum

 

newPage

Não

Nenhum

 

openDataObject

Sim

Nenhum

 

print

Sim

xfa.host.print();

Consulte o método print.

print

 

removeDataObject

Sim

Nenhum

 

removeField

Não

Nenhum

 

removeIcon

Sim

Nenhum

 

removeLinks

Não

Nenhum

 

removeScript

Sim

Nenhum

 

removeTemplate

Não

Nenhum

 

removeThumbnails

Não

Nenhum

 

removeWeblinks

Sim

Nenhum

 

replacePages

Não

Nenhum

 

resetForm

Não

xfa.host.resetData()

ou

xfa.event.reset()

O método resetData redefine todos os valores de campo em um formulário para os valores padrão. O método reset redefine todas as propriedades no modelo de eventos.

resetData

reset

saveAs

Sim

Nenhum

No Designer, o arquivo deve ser salvo no nível do aplicativo. Estes scripts são exemplos de como salvar no nível do aplicativo:

app.executeMenuItem ("SaveAs");

ou

var myDoc = event.target; myDoc.saveAs();

spawnPageFromTemplate

Não

Nenhum

 

setAction

Não

Nenhum

 

setPageLabel

Sim

Nenhum

 

setPageRotation

Não

Nenhum

 

setPageTabOrder

Não

Nenhum

No Designer, selecione Editar > Ordem das tabulações para definir a ordem de tabulação.

setScript

Não

Nenhum

 

submitForm

Sim

Use um dos objetos do botão de envio no Designer.

 

Propriedades do objeto event

change

Sim

xfa.event.change

change

Consulte a propriedade change.

targetName

Sim

xfa.event.target

target

Consulte a propriedade target.

Propriedades do objeto field

comb

Não

Nenhum

 

charLimit

Não

this.value.#text.maxChars

Nos formulários com um layout fixo, o limite de caracteres pode ser definido na área de trabalho do Designer. É possível definir campos nos formulários cujo layout é ampliado para acomodar todos os dados.

maxChars

display = display.noView

Não

Consulte Alteração da presença de um objeto de design de formulário.

presence

Também é possível definir a propriedade presence na área de trabalho do Designer.

Você não pode usar o evento prePrint para alterar a presença de um objeto antes da impressão.

display = display.noPrint

Não

Consulte Alteração da presença de um objeto de design de formulário.

presence

Também é possível definir a propriedade presence na área de trabalho do Designer.

Você não pode usar o evento prePrint para alterar a presença de um objeto antes da impressão.

defaultValue

Não

Nenhum

Defina o valor padrão do campo na área de trabalho do Designer.

exportValues

Não

Nenhum

Defina o valor de exportação na área de trabalho do Designer.

fillColor

Não

xfa.form.Form1. NumericField1.fillColor

fillColor

Consulte a propriedade fillColor.

hidden

Não

this.presence = "invisible" this.presence = "visible"

presence

Também é possível definir a propriedade presence na área de trabalho do Designer.

multiline

Não

this.ui.textEdit.multiLine = "1";

multiLine

Consulte a propriedade multiLine.

password

Não

Nenhum

O Designer contém um campo de senha que pode ser usado para as senhas em um formulário.

page

Não

Nenhum

Não aplicável aos formulários do Designer.

print

Não

this.relevant = "-print";

relevant

Consulte a propriedade relevant.

radiosInUnison

Não

Nenhum

Os botões de opção agrupados no Designer são mutuamente exclusivos por padrão.

rect

Sim

É possível obter a altura e a largura de um campo de formulário Designer usando a seguinte sintaxe de referência:

this.h; this.w;

Se preferir, recupere as coordenadas x e y de um objeto usando a seguinte sintaxe de referência:

this.x; this.y;

h, x, y

Consulte as propriedades h,w, x e y.

required

Não

this.mandatory = "error";

ou

this.validate.nullTest = "error";

mandatory, nullTest

Consulte as propriedades mandatory e nullTest.

textColor

Não

this.fontColor

fontColor

Consulte a propriedade fontColor.

textSize

Não

this.font.size

size

Consulte a propriedade size.

textFont

Não

this.font.typeface

typeface

Consulte a propriedade typeface.

value

Não

this.rawValue

rawValue

Consulte a propriedade rawValue.

value

Os campos do Designer têm uma propriedade value ; não é o equivalente da propriedade value do Acrobat.

Métodos do objeto field

clearItems

Não

DropDownList1.clearItems();

clearItems

O método clearItems aplica-se somente aos objetos de lista suspensa e caixa de listagem no Designer.

deleteItemAt

Não

Nenhum

 

getItemAt

Não

Nenhum

 

insertItemAt

Não

DropDownList1.addItem .....)

addItem

Consulte o método addItem.

isBoxChecked

Não

if(CheckBox1.rawValue == 1)....

rawValue

Consulte a propriedade rawValue.

isDefaultChecked

Não

Nenhum

 

setAction

Não

Nenhum

Não aplicável aos formulários do Designer.

setFocus

Sim

xfa.host.setFocus ("TextField1.somExpression")

setFocus

O método setFocus requer que o objeto especificado tenha um nome exclusivo de acordo com os outros objetos em seu formulário.

setItems

Não

Nenhum

 

setLock

Sim

Nenhum

 

signatureGetModifications

Sim

Nenhum

 

signatureGetSeedValue

Sim

Nenhum

 

signatureInfo

Sim

Nenhum

 

signatureSetSeedValue

Sim

Nenhum

 

signatureSign

Sim

Nenhum

 

signatureValidate

Sim

Nenhum

 

Método do objeto search

search.query("<o seu texto>");

Sim

Nenhum

A “..” (dois pontos) permite que você procure os objetos no Modelo de objeto de formulário XML.

Para obter mais informações, consulte Atalhos da sintaxe de referência do FormCalc.

Método do objeto SOAP

Todas as propriedades e métodos

Sim

Nenhum