trackContainerResize

  • Artículo

Determina el tamaño del contenedor si el componente necesita reaccionar. El componente recibirá allocatedWidth o allocatedHeight si la entrada es verdadera..

Cuando llama al método trackContainerResize(true), el context.mode.allocatedWidth y context.mode.allocatedHeight se proporcionará dentro del método updateView del componente de código. Los valores de estas propiedades son diferentes dependiendo de dónde se aloje el componente de código. Un valor de -1 indica que el componente de código puede establecer reglas de CSS Style para llenar el espacio disponible según sea necesario.

La siguiente tabla muestra los valores de allocatedWidth y allocatedHeight en las diferentes combinaciones de métodos de ciclo de vida de componentes de código y host.

Host Método del ciclo de vida allocatedWidth allocatedHeight
Aplicaciones de lienzo y basadas en modelo init -1 -1
Aplicaciones basadas en modelos updateView -1 Si trackContainerResize(false) o
ancho en píxeles si trackContainerResize(true)
El ancho cambiará a medida que se cambie el tamaño de la ventana del navegador y el formulario se ajuste al espacio disponible.		 -1
Aplicaciones de lienzo updateView Establecido por el fabricante de la aplicación.
Puede cambiar dinámicamente si el ancho se establece en una fórmula Power FX.		 Establecido por el fabricante de la aplicación.
Puede cambiar dinámicamente si el ancho se establece en una fórmula Power FX.

Nota

En la herramienta de ejecución de prueba (empezando usando npm start), allocatedHeight y allocatedWidth se devolverán como cadenas en lugar de números. Cuando no se proporciona ningún valor, devolverán una cadena vacía en lugar de -1 o indefinido. Además, una vez que se establece el ancho o el alto, no puede deshacer los cambios sin actualizar el navegador, en su lugar, un valor en blanco se interpretará como un tamaño de 1.

En general, las aplicaciones basadas en modelos no restringen la altura y el ancho de un componente, por lo que no es necesario realizar un seguimiento del tamaño del contenedor. En cambio, los componentes del código pueden crecer para usar el 100% del espacio para los componentes de la cuadrícula o hasta una altura específica requerida por los contenidos al representar un componente field. En las aplicaciones de lienzo, sin embargo, el contexto principal siempre proporciona la altura y el ancho del componente por la naturaleza del editor de arrastrar y soltar.

La siguiente tabla muestra las estrategias que puede utilizar para controlar la altura y el ancho de los contenidos HTML de sus controles:

Host Tipo de componente de código Estrategia de tamaño de altura CSS Estrategia de tamaño de ancho CSS
Aplicaciones basadas en modelos dataset height: "100%" width: "100%"
Aplicaciones basadas en modelos field Crecer hasta una altura máxima
(El formulario de alojamiento también crecerá para adaptarse).		 width: "100%"
Aplicaciones basadas en modelos field (modo de pantalla completa) height: "100%" width: "100%"
Aplicaciones de lienzo dataset & field height: allocatedWidth width: allocatedHeight
Aplicaciones de lienzo dataset & field (modo de pantalla completa) height: "100%" width: "100%"

Si los valores allocatedWidth y allocatedHeight cambian después de la primera llamada a updateView, luego un updateView se llama con "layout" añadido a la context.updatedProperties. Más información: UpdatedProperties.

Disponible para

Aplicaciones basadas en modelos, aplicaciones de lienzo y portales.

Sintaxis

context.mode.trackContainerResize(value)

Parámetros

Nombre de parámetro Tipo Obligatorio Descripción
valor Boolean Sí True si los controles deben seguir el tamaño del contenedor, el componente recibirá allocatedWidth o allocatedHeight.

Mode
Referencia de la API de Power Apps component framework
Información general sobre Power Apps component framework

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).