WP Add picture

WP Add picture ( wpDoc {; picture} ) : Object
WP Add picture ( wpDoc {; picturePath} ) : Object
WP Add picture ( wpDoc {; pictureFileObj} ) : Object

Parámetros	Tipo		Descripción
wpDoc	Object	→	Documento 4D Write Pro
picture	Picture	→	Imagen 4D
picturePath	Text	→	Ruta de la imagen
pictureFileObj	4D.File	→	Objeto 4D.File que representa un archivo imagen
Resultado	Object	←	Objeto que hace referencia a la imagen

Descripción

El comando WP Add imagen ancla la imagen pasada como parámetro en una ubicación fija dentro del wpDoc especificado y devuelve su referencia. The returned reference can then be passed to the WP SET ATTRIBUTES command to move the picture to any location in wpDoc (page, section, header, footer, etc.) con una capa definida, tamaño, etc.

En wpDoc, pase el nombre de un objeto documento de 4D Write Pro.

For the optional second parameter, you can pass either:

• En imagen: una imagen 4D
• In picturePath: A string containing a path to a picture file stored on disk (system syntax). You can pass a full pathname, or a pathname relative to the database structure file. You can also pass a file name, in which case the file must be located next to the database structure file. If you pass a file name, you need to indicate the file extension.
• En PictureFileObj: un objeto 4D.File que representa un archivo imagen.

nota

Todo formato imagen soportado por 4D puede ser usado. Puede obtener la lista de formatos de imagen disponibles usando el comando PICTURE CODEC LIST. If the picture encapsulates several formats (codecs), 4D Write Pro only keeps one format for display and one format for printing (if different) in the document; the "best" formats are automatically selected.

• If picture is omitted, a valid picture reference is returned, and an empty image is added. Esto le permite llamar a WP SET ATTRIBUTES con el selector wk image expression para llenar la imagen con una expresión 4D. If the expression can not be evaluated or does not return a valid picture, an empty image (default black frame image) is displayed.

Por defecto, la imagen añadida es:

• Incorporado detrás del texto
• Aparece en la esquina superior izquierda de la papelera
• Mostrar en todas las páginas

The location, layer (inline, in front/behind text), visibility, and any properties of picture can be modified using the WP SET ATTRIBUTES command, or via standard actions (see Using 4D Write Pro standard actions).

Nota: el comando WP Selection range devuelve un objeto referencia a imagen si se selecciona una imagen anclada y un objeto rango si se selecciona una imagen en línea. You can determine if a selected object is a picture object by checking the wk type attribute:

• Value = 2: el objeto seleccionado es un objeto imagen.
• Valor = 0: el objeto seleccionado es un objeto de rango.

Ejemplo 1

You want to add a picture with default settings using a filepath.

 var $obPict : Object
 $obPict:=WP Add picture(myDoc;"/PACKAGE/Pictures/Saved Pictures/Sunrise.jpg")

El resultado es:

Ejemplo 2

You want to add a resized picture, centered and anchored to the header:

 var $obImage : Object
 var $myPictureFile : 4D.File

 $myPictureFile:=File("/PACKAGE/Pictures/Saved Pictures/Sunrise.jpg")
 $obImage:=WP Add picture(myDoc;$myPictureFile)
 WP SET ATTRIBUTES($obImage;wk anchor origin;wk header box)
 WP SET ATTRIBUTES($obImage;wk anchor horizontal align;wk center)
 WP SET ATTRIBUTES($obImage;wk anchor vertical align;wk center)
 WP SET ATTRIBUTES($obImage;wk width;"650px";wk height;"120px")

El resultado es:

Ejemplo 3

You want to use a field expression to add an anchored image to a document displaying some text from the database:

 QUERY([Flowers];[Flowers]Common_Name="tulip")
 WP SET TEXT(myDoc;[Flowers]Description;wk append) //insertar texto
 var $obImage : Object
 $obImage:=WP Add picture(myDoc)
 WP SET ATTRIBUTES($obImage;wk image formula;Formula([Flowers]Image))

Ver también

WP DELETE PICTURE
WP Picture range