WP INSERT PICTURE
WP INSERT PICTURE ( objRango ; imagen ; modo {; actRango} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| objRango | Objeto | 🡒 | Objeto de rango |
| imagen | Imagen | 🡒 | 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 |
Descripción
El comando WP INSERT PICTURE inserta una nueva ruptura de tipo tipoRuptura en el rango de selección objRango según el modo de inserción modo y el parámetro ActRango.
En objRango, pase:
- un rango, o
- un elemento (tabla / fila / párrafo / cuerpo / encabezado / pie de página / imagen en línea / sección / subsección), o
- un documento 4D Write Pro
En imagen, puede pasar:
- un campo imagen o variable, o
- una ruta de archivo (cadena) a un archivo imagen almacenado en el disco, en la sintaxis del sistema.
Si utiliza una cadena, puede pasar una ruta 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 de datos. Si pasa un nombre de archivo, debe indicar la extensión del archivo.
Se puede utilizar cualquier formato de imagen compatible con 4D (consulte la sección Imágenes). Puede obtener la lista de formatos de imagen disponibles con el comando PICTURE CODEC LIST. Si la imagen encapsula varios formatos (códecs), 4D Write Pro solo conserva un formato para mostrar y otro para imprimir (si es diferente) en el documento; Los "mejores" formatos son seleccionados automáticamente.
En el parámetro modo, pase una constante para indicar el modo de inserción que se utilizará para la ruptura en el rango de selección objRango:
| Constante | Tipo | Valor | Comentario |
|---|---|---|---|
| wk append | Entero largo | 2 | Inserta 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 |
- Si objRango es un rango, you can use the optional ActRango puede utilizar el parámetro opcional ActRango para pasar una de las siguientes constantes para especificar si los contenidos insertados están incluidos en el rango resultante:
| 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 el parámetro ActRango, por defecto los contenidos insertados están incluidos en el rango resultante.
- Si objRango no es un rango, ActRango se ignora.
Ejemplo
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:
var $wpRange : Object
$wpRange:=WP Get selection([EXAMPLES]wpDoc)
var $fail : Boolean
$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