Función CUSTPROPR
La función CUSTPROPR devuelve una propiedad personalizada de un rango determinado de propiedades personalizadas. Las propiedades personalizadas que devuelve la función CUSTPROPR() se basan en un identificador fijo al que se le añade un sufijo variable. El rango especifica el número (y los valores) de sufijos de variables disponibles para las propiedades, mientras que el desplazamiento selecciona qué sufijo de variable se va a utilizar.
Sintaxis
CUSTPROPR(«Identificador fijo», «Ámbito», «Intervalo», «Desplazamiento»)
Dónde
El identificador fijo es la etiqueta de la propiedad personalizada a la que se añadirá el sufijo de variable generado automáticamente.
El ámbito puede ser cualquiera de los siguientes valores:
-
C - Célula
-
P - Párrafo
-
T - Tabla
-
TR - Fila
-
TC - Columna
-
D - Configuración del documento
-
SSK: se trata de la sección más pequeña que incluye un enlace a la biblioteca de conocimientos y que abarca el objeto que contiene el cálculo (lo más sencillo es imaginarlo como un párrafo).
-
SSL: se trata de la sección más pequeña con una etiqueta que engloba el objeto que contiene el cálculo.
«Range» es una declaración de rango con formato. El sufijo de la variable se seleccionará de entre los valores disponibles especificados por este intervalo y se ajustará al desplazamiento indicado. Los valores del intervalo se introducen como dos números o cadenas ordenados de menor a mayor y separados por dos puntos. Por ejemplo, «1..5», «C..H» y «Z..AD» son entradas de intervalo válidas. CaseView recorre el rango de valores disponibles del mismo modo que se incrementan las etiquetas de las tablas o los números de celda. Es decir, A-Z seguido de AA, AB, AC, etc.
La opción «offset» especifica el sufijo variable, dentro del rango disponible, que debe añadirse al identificador fijo.
Notas
- Los intervalos excesivamente complejos, como una cadena de más de 100 caracteres, o las listas de intervalos excesivamente largas, como aquellas que dan lugar a más de 250 valores de sufijo de variable disponibles, se ignorarán y provocarán que la función falle.
- Para que sea válido, el valor del intervalo debe contener los dos puntos (..).
- Los valores de identificador fijo, ámbito y rango deben introducirse como cadenas estáticas. Un cálculo destinado a devolver un valor para estos componentes no funcionará correctamente.
- El desplazamiento puede ser un valor calculado.
- El identificador fijo y los valores del intervalo no distinguen entre mayúsculas y minúsculas.
Ejemplo
Supongamos que la celda C3 tiene un valor de 2 y que el párrafo tiene una propiedad personalizada DEF2 cuyo valor es 15.
CUSTPROPR("DEF", "p", "1..5", C3) devolvería el valor 15.
La función busca una propiedad de párrafo en función del ámbito. Añade los sufijos de variables aplicables al identificador fijo DEF y devuelve un conjunto de posibles propiedades personalizadas: DEF1, DEF2, DEF3, DEF4 y DEF5. En este caso, el desplazamiento es un valor calculado (un número de celda) y la función sigue esa referencia para determinar que el desplazamiento es 2.
Se devuelve DEF2 como la propiedad personalizada del párrafo correspondiente, cuyo valor es 15.
Temas relacionados