Ir al contenido

Capítulo 32: SelectionSet (Interactuar con la Selección)

Cap 32: SelectionSet (Interactuar con la Selección)

Parte XIII - Sección 26 - Nivel: Avanzado

La mayoría de los scripts de la API de Objetos (Selection.SelectedPages) funcionan perfectos cuando tienes una licencia completa de API. Pero si estás restringido a acciones CLI o necesitas interactuar con selectores más complejos como la Gestión de Proyectos, la acción selectionset es tu aliada.

1. La Acción `selectionset`

Esta acción es única porque no ejecuta nada. Su propósito es leer el estado actual de la interfaz de usuario y devolverlo al script a través del ActionCallingContext.

Parámetro (Input)	Descripción
`TYPE`	`PAGES`, `PROJECTS` (Gestión), `TESTRESULTS` (Gestión de mensajes).

Parámetro (Output)	Descripción
`PAGES`	String separado por `;` con nombres de páginas.
`PROJECTS`	String separado por `;` con rutas de proyectos.

2. Patrón de Uso: `GetParameter`

A diferencia de otras acciones donde solo hacemos AddParameter, aquí es crítico el uso de GetParameter después del Execute.

cli.Execute("selectionset", acc);

string resultado = "";
acc.GetParameter("PAGES", ref resultado);
// resultado ahora contiene "E1.01;E1.02;..."

3. Casos de Uso

Validación Previa: Antes de lanzar un script pesado, verifica cuántos objetos ha seleccionado el usuario.
Multiselección en Gestión: Si quieres hacer un backup de 3 proyectos específicos seleccionados en la lista de gestión, selectionset con TYPE:PROJECTS te da sus rutas exactas.

Resumen

selectionset lee la selección actual de la GUI.
Usa GetParameter para extraer la información.
Es vital para scripts interactivos que responden a “lo que el usuario está viendo”.

En el próximo capítulo, veremos una técnica muy potente: Filtros de Páginas.