Objetos de JavaScript de Acrobat admitidos en Designer

En la tabla siguiente se muestra la disponibilidad en Acrobat de los objetos, propiedades y métodos de Acrobat más utilizados en Designer, y proporciona información sobre funciones equivalentes en Designer. Aunque la tabla contiene los objetos, las propiedades y los métodos más utilizados de Acrobat, algunos no aparecen, como los objetos multimedia, porque no suelen utilizarse en los formularios.

En los casos en que no se incluye ninguna función de Designer equivalente, no existe ninguna propiedad ni método de Designer que pueda reproducir el comportamiento de Acrobat. Sin embargo, se pueden crear funciones o secuencias de comandos personalizadas para reproducir el comportamiento de Acrobat.

JavaScript en Acrobat

Compatibilidad en Designer

Equivalente de JavaScript en Designer

Comentarios

Propiedades y métodos del objeto annot

Todas las propiedades y métodos

Ninguno

Sólo los formularios con una presentación fija admiten la capa de anotación.

Propiedades del objeto app

calculate

No

Ninguno

Designer incluye el método execCalculate, que inicia el suceso calculate.

execCalculate

language

xfa.host.language

Consulte la propiedad language.

language

monitors

Ninguno

 

platform

xfa.host.platform

Consulte la propiedad platform.

platform

plugins

Ninguno

 

toolbar

Ninguno

 

viewerType

xfa.host.appType

Consulte la propiedad appType.

appType

viewerVariation

xfa.host.variation

Consulte la propiedad variation.

variation

viewerVersion

xfa.host.version

Consulte la propiedad version.

version

Métodos del objeto app

addMenuItem

Ninguno

 

addSubMenu

Ninguno

 

addToolButton

Ninguno

 

alert

xfa.host.messageBox()

Consulte el método messageBox.

messageBox

beep

xfa.host.beep()

Consulte el método beep.

beep

browseForDoc

Ninguno

 

clearInterval

Ninguno

 

clearTimeOut

Ninguno

 

execDialog

Ninguno

 

execMenuItem

Ninguno

Ejecuta el comando de menú especificado. Este método se utiliza en Designer para los comandos del menú Archivo.

getNthPluginName

Ninguno

 

getPath

Ninguno

 

goBack

Ninguno

 

goForward

Ninguno

 

hideMenuItem

Ninguno

 

hideToolbarButton

Ninguno

 

launchURL

Ninguno

Designer incluye el método gotoURL, que carga una URL en la aplicación cliente, por ejemplo, Acrobat o Adobe Reader.

gotoURL

listMenuItems

Ninguno

 

listToolbarButtons

Ninguno

 

mailGetAddrs

Ninguno

 

mailMsg

Ninguno

 

newDoc

Ninguno

Este método sólo se puede ejecutar durante sucesos de lote, de consola o de menú.

newFDF

No

Ninguno

 

openDoc

Ninguno

 

openFDF

No

Ninguno

 

popUpMenuEx

Ninguno

 

popUpMenu

Ninguno

 

removeToolButton

Ninguno

 

response

xfa.host.response()

Consulte el método response.

response

setInterval

Ninguno

 

setTimeOut

Ninguno

 

trustedFunction

Ninguno

 

trustPropagatorFunction

Ninguno

Este método sólo está disponible durante el inicio de lote, consola y aplicación.

Propiedades y métodos del objeto bookmark

Todas las propiedades y métodos

Ninguno

 

Propiedades del objeto doc

author

Ninguno

 

baseURL

Ninguno

 

bookmarkRoot

Ninguno

 

calculate

No

Ninguno

 

dataObjects

Ninguno

 

delay

No

Ninguno

 

dirty

Ninguno

Con esta secuencia de comandos de JavaScript para Designer se guarda una copia de un formulario y se comprueba si el formulario ha cambiado:

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

disclosed

Ninguno

 

documentFileName

Ninguno

 

dynamicXFAForm

Ninguno

 

external

Ninguno

 

filesize

Ninguno

 

hidden

Ninguno

 

icons

Ninguno

 

keywords

Ninguno

 

layout

Ninguno

 

media

Ninguno

 

metadata

xfa.form.desc

Consulte el objeto desc.

desc

modDate

Ninguno

 

mouseX mouseY

Ninguno

 

noautocomplete

Ninguno

 

nocache

Ninguno

 

numFields

xfa.layout.pageContent()

El método pageContent devuelve una lista de todos los objetos de un tipo concreto. Sin embargo, debe ejecutar el método en vistas de diseño y páginas de formato para analizar todo el formulario.

pageContent

numPages

xfa.host.numPages

or

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

La propiedad numPages devuelve el número de páginas del formulario representado en el cliente. Consulte también los métodos absPageCount y pageCount.

numPages

absPageCount

pageCount

pageNum

xfa.host.currentPage

Consulte la propiedad currentPage.

currentPage

pageNum--

xfa.host.currentPage--

or

xfa.host.pageUp()

Consulte la propiedad currentPage o el método pageUp.

currentPage

pageUp

pageNum++

xfa.host.currentPage++

or

xfa.host.pageDown()

Consulte la propiedad currentPage o el método pageDown.

currentPage

pageDown

path

Ninguno

 

securityHandler

Ninguno

 

templates

No

Ninguno

Se deben utilizar objetos de subformulario en Designer y emplear propiedades y métodos para agregar, quitar, mover y definir instancias de subformulario.

Adición y eliminación de las instancias de subformulario mediante una secuencia de comandos

title

xfa.host.title

Consulte title.

Métodos del objeto doc

addAnnot

Ninguno

 

addField

No

Ninguno

Es necesario utilizar formularios que tengan una presentación fija en Designer y luego usar el objeto instanceManager para agregar, quitar y definir el número de instancias de un objeto concreto.

instanceManager

Para obtener más información, consulte Adición y eliminación de las instancias de subformulario mediante una secuencia de comandos.

addIcon

Ninguno

 

addLink

No

Ninguno

 

addRecipientListCryptFilter

Ninguno

 

addScript

Ninguno

 

addThumbnails

No

Ninguno

 

addWatermarkFromFile

Ninguno

 

addWatermarkFromText

Ninguno

 

addWeblinks

Ninguno

 

appRightsSign

Ninguno

 

appRightsValidate

Ninguno

 

bringToFront

Ninguno

 

calculateNow

No

xfa.form.recalculate(1);

or

execCalculate()

recalculate

El método recalculate fuerza el inicio de un conjunto específico de secuencias de comandos en los sucesos calculate. Mediante el valor booleano True (predeterminado) se indica que se deben iniciar todas las secuencias de comandos de cálculo; con el valor booleano False se indica que sólo se deben iniciar las secuencias de comandos de cálculo pendientes.

Designer incluye el objeto calculate, que controla si el usuario que rellena el formulario puede anular el valor calculado de un campo.

execCalculate

Como alternativa, puede utilizar el método execCalculate para cada objeto para el que quiera forzar un nuevo cálculo.

closeDoc

Ninguno

 

createDataObject

Ninguno

 

createTemplate

No

Ninguno

En los formularios de Designer no existe un concepto equivalente a las plantillas de Acrobat. En Designer, se deben utilizar objetos de subformulario.

deletePages

No

Ninguno

instanceManager

En Designer, puede utilizar el objeto instanceManager para quitar el objeto de subformulario que represente una página del formulario.

Para obtener más información, consulte Adición y eliminación de las instancias de subformulario mediante una secuencia de comandos.

embedDocAsDataObject

Ninguno

 

encryptForRecipients

Ninguno

 

encryptUsingPolicy

Ninguno

 

exportAsText

Ninguno

Este método sólo está disponible en la consola o en el depurador de JavaScript de Acrobat durante el procesamiento por lotes.

exportAsFDF

No

xfa.host.exportData()

exportData

El método exportData exporta un archivo XML o XDP en lugar de un archivo FDF.

exportAsXFDF

No

xfa.host.exportData()

exportData

El método exportData exporta un archivo XML o XDP en lugar de un archivo FDF.

exportDataObject

Ninguno

 

exportXFAData

No

xfa.host.exportData()

exportData

El método exportData exporta un archivo XML o XDP en lugar de un archivo FDF.

extractPages

No

Ninguno

 

flattenPages

No

Ninguno

 

getAnnot

Ninguno

 

getAnnots

Ninguno

 

getDataObjectContents

Ninguno

 

getField("FieldName")

xfa.resolveNode ("FieldName")

resolveNode

El método resolveNode accede al objeto especificado en el código fuente XML del formulario.

getLegalWarnings

Ninguno

 

getLinks

No

Ninguno

 

getNthFieldName

Se deben recorrer en bucle todos los objetos que presenten el mismo nombre de clase hasta que se alcanza la incidencia nth.

className

Consulte la propiedad className.

getNthTemplate

No

Ninguno

 

getOCGs

Ninguno

 

getOCGOrder

Ninguno

 

getPageBox

Ninguno

 

getPageLabel

Ninguno

 

getPageNthWord

Ninguno

 

getPageNthWordQuads

Ninguno

 

getPageNumWords

Ninguno

 

getPageRotation

Ninguno

 

getPrintParams

Ninguno

 

getTemplate

No

Ninguno

 

getURL

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

Consulte el método gotoURL.

gotoURL

 

gotoNamedDest

No

Ninguno

 

importAnFDF

No

Ninguno

 

importAnXFDF

Ninguno

 

importDataObject

Ninguno

 

importIcon

Ninguno

 

importTextData

Ninguno

 

importXFAData

No

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

Consulte el método importData.

importData

insertPages

No

Ninguno

 

mailDoc

Ninguno

 

mailForm

No

Ninguno

 

movePage

No

Ninguno

 

newPage

No

Ninguno

 

openDataObject

Ninguno

 

print

xfa.host.print();

Consulte el método print.

print

 

removeDataObject

Ninguno

 

removeField

No

Ninguno

 

removeIcon

Ninguno

 

removeLinks

No

Ninguno

 

removeScript

Ninguno

 

removeTemplate

No

Ninguno

 

removeThumbnails

No

Ninguno

 

removeWeblinks

Ninguno

 

replacePages

No

Ninguno

 

resetForm

No

xfa.host.resetData()

or

xfa.event.reset()

El método resetData restaura todos los valores predeterminados de campo de un formulario. El método reset restaura todas las propiedades del modelo de sucesos.

resetData

reset

saveAs

Ninguno

En Designer, el archivo se debe guardar en la aplicación. Estas secuencias de comandos son ejemplos de cómo guardar en la aplicación:

app.executeMenuItem ("SaveAs");

or

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

spawnPageFromTemplate

No

Ninguno

 

setAction

No

Ninguno

 

setPageLabel

Ninguno

 

setPageRotation

No

Ninguno

 

setPageTabOrder

No

Ninguno

En Designer, se debe seleccionar Editar > Orden de tabulación para definir el orden.

setScript

No

Ninguno

 

submitForm

Se debe utilizar uno de los objetos de botón de envío en Designer.

 

Propiedades del objeto event

change

xfa.event.change

change

Consulte la propiedad change.

targetName

xfa.event.target

target

Consulte la propiedad target.

Propiedades del objeto field

comb

No

Ninguno

 

charLimit

No

this.value.#text.maxChars

En los formularios que tengan una presentación fija, se puede definir el límite de caracteres en el espacio de trabajo de Designer. Se pueden definir campos en los formularios cuya presentación se expanda para dar cabida a todos los datos.

maxChars

display = display.noView

No

Consulte Cambio de la presencia de un objeto de diseño de formulario.

presence

También se puede definir la propiedad presence en el espacio de trabajo de Designer.

No se puede utilizar el suceso prePrint para cambiar la presencia de un objeto antes de que se imprima.

display = display.noPrint

No

Consulte Cambio de la presencia de un objeto de diseño de formulario.

presence

También se puede definir la propiedad presence en el espacio de trabajo de Designer.

No se puede utilizar el suceso prePrint para cambiar la presencia de un objeto antes de que se imprima.

defaultValue

No

Ninguno

Se debe definir el valor predeterminado del campo en el espacio de trabajo de Designer.

exportValues

No

Ninguno

Se debe definir el valor de exportación en el espacio de trabajo de Designer.

fillColor

No

xfa.form.Form1. NumericField1.fillColor

fillColor

Consulte la propiedad fillColor.

hidden

No

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

presence

También se puede definir la propiedad presence en el espacio de trabajo de Designer.

multiline

No

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

multiLine

Consulte la propiedad multiLine.

password

No

Ninguno

Designer incluye un campo de contraseña que se puede utilizar en los formularios.

page

No

Ninguno

No se aplica a formularios de Designer.

print

No

this.relevant = "-print";

relevant

Consulte la propiedad relevant.

radiosInUnison

No

Ninguno

Los botones de radio agrupados en Designer son mutuamente excluyentes de forma predeterminada.

rect

Se puede obtener la altura y la anchura de un campo de un formulario de Designer utilizando la siguiente sintaxis de referencia:

this.h; this.w;

También se pueden obtener las coordenadas x e y de un objeto con la siguiente sintaxis de referencia:

this.x; this.y;

h, x, y

Consulte las propiedades h, w, x e y.

required

No

this.mandatory = "error";

or

this.validate.nullTest = "error";

mandatory, nullTest

Consulte las propiedades mandatory y nullTest.

textColor

No

this.fontColor

fontColor

Consulte la propiedad fontColor.

textSize

No

this.font.size

size

Consulte la propiedad size.

textFont

No

this.font.typeface

typeface

Consulte la propiedad typeface.

value

No

this.rawValue

rawValue

Consulte la propiedad rawValue.

value

Los campos de Designer tienen una propiedad value que es equivalente a la propiedad value de Acrobat.

Métodos del objeto field

clearItems

No

DropDownList1.clearItems();

clearItems

El método clearItems solo se aplica a objetos de lista desplegable y cuadro de lista de Designer.

deleteItemAt

No

Ninguno

 

getItemAt

No

Ninguno

 

insertItemAt

No

DropDownList1.addItem .....)

addItem

Consulte el método addItem.

isBoxChecked

No

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

rawValue

Consulte la propiedad rawValue.

isDefaultChecked

No

Ninguno

 

setAction

No

Ninguno

No se aplica a formularios de Designer.

setFocus

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

setFocus

El método setFocus requiere que el objeto especificado tenga un nombre único con respecto al resto de objetos del formulario.

setItems

No

Ninguno

 

setLock

Ninguno

 

signatureGetModifications

Ninguno

 

signatureGetSeedValue

Ninguno

 

signatureInfo

Ninguno

 

signatureSetSeedValue

Ninguno

 

signatureSign

Ninguno

 

signatureValidate

Ninguno

 

Método del objeto search

search.query("<texto>");

Ninguno

El método abreviado de sintaxis “..” (puntos dobles) de FormCalc permite buscar objetos en el Modelo de objetos de formulario XML.

Para obtener más información, consulte Métodos abreviados de sintaxis de referencia de FormCalc.

Método del objeto SOAP

Todas las propiedades y métodos

Ninguno