AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / Desarrollar una aplicación o un sitio web / Controles, ventanas y páginas / Controles: tipos disponibles / Supercontrol
  • Presentación
  • Creación de un supercontrol en el editor
  • Método 1
  • Método 2
  • Añadiendo un control en un supercontrol
  • Supercontroles y barras de desplazamiento
  • Programación de un supercontrol
  • Declarando las variables globales de supercontrol
  • Declaración de las funciones y procedimientos relacionado al supercontrol
  • Acceso al supercontrol y a los controles del supercontrol
  • El valor de un supercontrol
  • Funciones y propiedades específicas de los supercontroles
  • Funciones específicas de los supercontroles
  • Propiedades específicas de los supercontroles
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Diseñando un supercontrol
Presentación
Un supercontrol es un tipo avanzado de control. Un supercontrol agrupa una set de controles para un propósito específico. Los controles son independientes de los procesos realizados en la ventana o Page que los contiene.
Dos tipos de usuarios están autorizados a manipular un supercontrol:
  • El creador de del supercontrol: persona que diseña el supercontrol así como sus características.
  • El usuario del supercontrol: persona que integrará el supercontrol en la ventana (o Page) y lo manipular programáticamente. Para obtener más información, consulte: Incluir un supercontrol en una ventana o en una Page.
Creación de un supercontrol en el editor
Se pueden utilizar dos métodos para crear un supercontrol:
  • Crear un supercontrol vacío y crear los controles incluidos en el supercontrol.
  • Creación de un supercontrol a partir de los controles existentes.
Observación: No se puede añadir ningún supercontrol personalizado a los supercontroles propuestos por WINDEV, WEBDEV y WINDEV Mobile.

Método 1

  1. En la ventana o editor Page, en la pestaña "Creación", en el grupo "Contenedores", haga clic en "Supercontrol".
  2. Haga clic en la ventana o página en la ubicación en la que desea crear el control. Se visualiza el esquema del supercontrol.
  3. Abra la descripción del control (seleccione "Descripción" en el menú contextual).
  4. Añade los diferentes campos que componen el supercontrol (botón "Add'").
Atención: Los controles associated con el supercontrol deben pertenecer al área de supercontrol definida en el editor. De lo contrario, la control será Grayed en el editor y no se mostrará en tiempo de ejecución.

Método 2

  1. En el editor de ventanas o en el editor Page, cree los diferentes controles que se incluyen en el supercontrol.
  2. Seleccione los controles (tecla Ctrl + clic del ratón o con el lazo).
  3. En la pestaña "Modificación", en el grupo "Transformaciones", amplíe "Refactorización y permutaciones" y seleccione "Crear un supercontrol a partir de la selección".
Observación: Los controles que son associated con el supercontrol se anclan respecto al supercontrol (y no respecto a la ventana o Page).

Añadiendo un control en un supercontrol

Para añadir un control en un supercontrol:
  1. Crear (si es necesario) la control que debe añadirse a la supercontrol.
  2. Coloca el control en la zona de supercontrol. El área de supercontrol está bordeada por un Line verde.
    El control se añade automáticamente al supercontrol.

Supercontroles y barras de desplazamiento

Un supercontrol se realiza a partir de una zona visualizada (asas Black) y una zona visualizable (asas rojas).
Para modificar una de estas dos áreas, mueva las manijas mientras mantiene pulsada la tecla Mayúsculas.
Si el área visualizada es más pequeña que el área visualizable, las barras de desplazamiento se muestran automáticamente.
Se utiliza para crear supercontroles con barras de desplazamiento que permiten desplazar el contenido del supercontrol.
Programación de un supercontrol

Declarando las variables globales de supercontrol

El supercontrol incluye un código de declaración de las variables globales (véase Eventos associated con el supercontrol). Este código se utiliza para declarar todas las variables globales al supercontrol. Se soportan todos los tipos de variables. Se pueden utilizar en cualquier Event associated con el supercontrol o con uno de los controles incluidos en el supercontrol.

Declaración de las funciones y procedimientos relacionado al supercontrol

Para crear un Procedure local al supercontrol:
  1. Muestra el supercontrol description.
  2. Haga clic en el botón "Añadir" que se encuentra debajo de los "Procedimientos locales" control. Se crea un nuevo Procedure.
  3. Haga clic en el botón "Código" para editar el código de Procedure.
Consejo: Para crear procedimientos locales relacionado para el supercontrol, puede realizar las siguientes operaciones:
  1. Seleccione su ventana (o Page) y el supercontrol en el panel "Explorador de proyectos".
  2. Haga clic en la flecha Black que se encuentra junto al nombre del supercontrol en el explorador del proyecto. Aparecen los procedimientos locales.
  3. Seleccione "Procedimientos locales".. Los procedimientos locales que se muestran son los de supercontrol. Tiene la posibilidad de añadir, renombrar o borrar procedimientos locales en el supercontrol.

Acceso al supercontrol y a los controles del supercontrol

Al programar el supercontrol, debe acceder:
  • El supercontrol:
    Como la Process debe ser independiente del nombre del supercontrol, para get el nombre del supercontrol, se recomienda utilizar la palabra clave MyParent o funciones como ControlContextMenu, ControlCurrent, etc.
  • Los controles de supercontrol:
    Para ello, utilice directamente la variable del control en el código. Desde fuera de la supercontrol (código del menú contextual de la supercontrol control, por ejemplo), debe utilizar la siguiente notación:
    <Supercontrol name>.<Control name>
Observación: EnumControl se utiliza para listar los controles que pertenecen a un supercontrol.
Ejemplo
El siguiente ejemplo corresponde al código de una opción de un menú contextual. Este menú es associated con un control de un supercontrol y se usa para modificar los control s "StartDate" y "EndDate" del supercontrol.
En este código, el nombre del supercontrol actual es devuelto por ControlContextMenu. Los controles que se encuentran en el supercontrol son manejados por los operadores indirectos.
// Retrieves the current supercontrol
sSuperControl is string
sSuperControl = ExtractString(PopupField(), 1, ".")
dDate is Date     // Today's date by default
// Goes to the previous day
dDate..Day--
// Displays the date of previous day
{sSuperControl+".StartDate"}..Value = dDate
{sSuperControl+".EndDate"}..Value = dDate

El valor de un supercontrol

Un supercontrol incluye varios controles y puede devolver un valor. Este valor puede corresponder al valor de una control que se encuentra en la supercontrol o a cualquier otra información. Este valor es una cadena vacía de Default. Se puede modificar mediante la Valor Property o asignándole directamente un valor.
Ejemplo: Un supercontrol se utiliza para seleccionar un archivo. Contiene un control Campo de entrada y un botón para abrir el selector de archivos.. El valor del supercontrol debe corresponderse con el nombre del archivo seleccionado. Para ello, se debe asignar el valor del supercontrol:
  • en el código de modificación de la control Campo de entrada,
  • en el código de clic del botón de selección.En este código, la palabra clave MyParent se utiliza para designar el supercontrol en el código de uno de sus propios controles.
// Modification code of the edit control
MyParent = MySelf
// Code of selection button
FileName = fSelect(fExtractPath(FileName, fDirectory), ...
fExtractPath(FileName, fFile + fExtension), ...
"Select a file", ...
"All files (*.*)" + TAB + "*.*", "")
MyParent = FileName
Funciones y propiedades específicas de los supercontroles

Funciones específicas de los supercontroles

Las siguientes funciones se utilizan para gestionar las características de un supercontrol a través de la programación.
EnumControlDevuelve el nombre del Nth control perteneciente al supercontrol.
ReiniciarReinicializa los controles que se encuentran en un supercontrol.
WinUsefulSizeEspecifica el tamaño de useful para los supercontroles con barras de desplazamiento.

Propiedades específicas de los supercontroles

Las siguientes propiedades se pueden utilizar para programar manipular un supercontrol.
AlturaObtiene y establece la altura del supercontrol.
anchuraObtiene y establece el ancho del supercontrol.
denominarObtiene el nombre del supercontrol.
ValorObtiene y establece el valor del supercontrol.

Para obtener una lista completa de las propiedades de WLanguage que pueden utilizarse con un supercontrol, consulte Propiedades associated con un supercontrol.
Ver también
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 10/03/2023

Señalar un error o enviar una sugerencia | Ayuda local