Saltar al contenido principal
Versión: 20 R10

WP Get attributes

WP Get attributes ( targetObj ; ...attribName ; ...attribValue ) : Object
WP Get attributes ( targetObj ; attribColl ) : Object

ParámetrosTipoDescripción
targetObjObjectRango o elemento o documento 4D Write Pro
attribNameTextNombre del atributo a obtener
attribValueText, Number, Array, Collection, Picture, DateValor actual del atributo para el objetivo
attribCollCollectionColección de nombres de atributos a obtener
ResultadoObjectNombres y valores de los atributos

Descripción

El comando WP Get attributes devuelve el valor de todo atributo en un rango 4D Write Pro, encabezado, cuerpo, pie de página, tabla o documento. This command gives you access to any kind of 4D Write Pro internal attributes: character, paragraph, document, table, or image.

En targetObj, puede pasar:

  • un rango, o
  • un elemento (encabezado / pie de página / cuerpo / tabla / párrafo / imagen anclada / sección / subsección / hoja de estilo), o
  • un documento 4D Write Pro

En attribName, pase el nombre del atributo a recuperar.

También puede pasar una colección de nombres de atributos en attribColl, en cuyo caso el comando devolverá un objeto que contiene los nombres de atributos pasados en attribColl junto con sus valores correspondientes.

Para obtener una lista completa de los atributos a pasar, así como su alcance y valores, consulte la sección Atributos 4D Write Pro.

Si hay diferentes valores para el mismo atributo en el elemento pasado como parámetro, el comando regresa:

  • para valores numéricos, wk mixed
  • para los arrays, se devuelve un array vacío (tabulación, color si attribValue se definió como un array), con una excepción para wk text shadow offset para el que el valor del array siempre contendrá 2 entradas que pueden definirse por separado a wk mixed si se mezclan el desplazamiento horizontal o el desplazamiento vertical (o ambos).
  • para valores cadena, una cadena vacía
  • para valores imagen, una imagen vacía.

Nota: si targetObj contiene una hoja de estilo de párrafo y otra de caracter, se devuelve el nombre de la hoja de estilo de párrafo.

Ejemplo 1

Desea obtener el color de fondo del área seleccionada:

 $range:=WP Selection range(*;"WParea")
WP Get attributes($range;wk background color;$bcol)

Ejemplo 2

Desea obtener el tamaño de la fuente, el color de fondo y el estilo del borde del área seleccionada utilizando una colección:

 $range:=WP Selection range(*;"WParea")
$collection:=New collection(wk font size; wk background color; wk border style)
$attributes:=WP Get attributes($range; $collection)

Ver también

4D Write Pro Attributes
WP RESET ATTRIBUTES
WP SET ATTRIBUTES