4D v16
WP INSERT PICTURE
- Referencia 4D Write Pro
-
- Lenguaje 4D Write Pro
-
- Objetos 4D Write Pro
- Utilizar los comandos del tema Objeto (Formularios)
- Utilizar los comandos del tema Texto con estilo
- Acceder a contenidos de documentos por programación
- Constantes 4D Write Pro
- WP SET ATTRIBUTES
- WP CREATE BOOKMARKNew
- WP DELETE BOOKMARKNew
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get bookmark rangeNew
- WP GET BOOKMARKSNew
- WP Get page countNew
- WP Get paragraphs
- WP Get pictures
- WP Get range
- WP Get selection
- WP Import document
- WP INSERT BREAKNew
- WP INSERT DOCUMENTNew
- WP INSERT PICTURENew
- WP Is font style supported
- WP NewUpd
- WP PRINTUpd
- WP RESET ATTRIBUTES
- WP SELECT
- WP USE PAGE SETUP
- Atributos 4D Write Pro
WP INSERT PICTURE
| WP INSERT PICTURE ( objRango ; imagen ; modo {; actRango} ) | ||||||||
| Parámetro | Tipo | Descripción | ||||||
| objRango | Objeto |
|
Objeto de rango | |||||
| imagen | Imagen, Cadena |
|
Campo o variable imagen, o ruta del archivo de imagen en el disco | |||||
| modo | Entero largo |
|
Modo de inserción | |||||
| actRango | Entero largo |
|
Modo actualizar rango | |||||
El comando WP INSERT PICTURE inserta la imagen en el objRango de acuerdo con el modo de inserción especificado. La imagen se insertará como un carácter en objRango.
En objRango, pase un objeto rango estándar 4D Write Pro. Un objRango es una parte de un documento 4D Write Pro; puede crearse utilizando los comandos , WP Get bookmark range o WP Get range.
En imagen, puede pasar:
- ya sea un campo o variable imagen 4D,
- o una cadena que contenga una ruta a un archivo imagen almacenado en el disco, expresado utilizando la sintaxis del sistema.
Si utiliza una cadena, puede pasar una ruta de acceso completa, o una ruta relativa al archivo de estructura de la base. También puede pasar un nombre de archivo, en cuyo caso el archivo debe estar ubicado junto al archivo de estructura de la base. Si pasa un nombre de archivo, es necesario indicar la extensión del archivo.
Todo formato imagen soportado por 4D se puede utilizar (ver la sección Introducción a las imágenes). Puede obtener la lista de formatos imagen disponibles utilizando el comando PICTURE CODEC LIST. Si la imagen encapsula varios formatos (codecs), 4D Write Pro sólo mantiene un formato para visualizar y un formato para la impresión (si es diferente) en el documento; los "mejores" formatos se seleccionan automáticamente.
En el parámetro modo, pase una de las siguientes constantes para indicar el modo de inserción a utilizar en la imagen en el documento:
| Constante | Tipo | Valor | Comentario |
| wk append | Entero largo | 2 | Insertar contenidos al final del rango |
| wk prepend | Entero largo | 1 | Insertar contenidos al principio del rango |
| wk replace | Entero largo | 0 | Remplazar el contenido de la página |
En el parámetro actRango opcional, puede pasar una de las siguientes constantes para especificar si la imagen insertada está incluida o no en el rango:
| Constante | Tipo | Valor | Comentario |
| wk exclude from range | Entero largo | 1 | Contenidos insertados no incluidos en el rango actualizado |
| wk include in range | Entero largo | 0 | Contenido insertado incluido en el rango actualizado (predeterminado) |
Si no pasa un parámetro actRango, por defecto la imagen insertada está incluida en el rango.
En el ejemplo siguiente, un usuario selecciona la imagen que desea insertar en el objeto de rango y se le avisará si esta imagen no puede insertarse:
C_OBJECT($wpRange)
$wpRange:=WP Get selection([EXAMPLES]wpDoc)
C_BOOLEAN($fail)
$fail:=False
//pedir al usuario elegir una imagen en el disco que desee insertar
$imgRef:=Open document("")
//si el usuario no cancela
If(OK=1)
//si el archivo es un archivo de imagen soportado
If(Is picture file(document))
// inserta imagen seleccionada por el usuario
WP INSERT PICTURE($wpRange;document;wk replace)
Else
$fail:=True
End if
Else
$fail:=True
End if
//si la inserción falla, alerta al usuario
If($fail)
ALERT("Picture insertion failed")
End if
Producto: 4D
Tema: Lenguaje 4D Write Pro
Creado por: 4D v16
Referencia 4D Write Pro ( 4D v16)
