trackContainerResize

Determina il dimensionamento del contenitore se il componente deve reagire. Il componente otterrà allocatedWidth o allocatedHeight se l'input è true.

Quando si chiama il trackContainerResize(true) metodo , context.mode.allocatedWidth e context.mode.allocatedHeight verrà fornito all'interno del updateView metodo del componente di codice. I valori di queste proprietà sono diversi a seconda della posizione in cui è ospitato il componente di codice. Un valore indica -1 che il componente di codice può impostare le regole di stile CSS per riempire lo spazio disponibile in base alle esigenze.

Nella tabella seguente vengono illustrati i valori di allocatedWidth e allocatedHeight nelle diverse combinazioni di metodi del ciclo di vita dell'host e del componente del codice.

Host	Lifecycle, metodo	allocatedWidth	allocatedHeight
App basate su modello e canvas	init	-1	-1
App basate su modello	updateView	-1 se trackContainerResize(false) o larghezza in pixel se trackContainerResize(true) La larghezza cambierà man mano che la finestra del browser viene ridimensionata e il modulo si adatta allo spazio disponibile.	-1
App canvas	updateView	Impostato dall'autore dell'app. Può cambiare dinamicamente se la larghezza è impostata su una formula Power FX.	Impostato dall'autore dell'app. Può cambiare dinamicamente se la larghezza è impostata su una formula Power FX.

Annotazioni

Nel test harness (iniziato a usare npm start), e allocatedHeightallocatedWidth verrà restituito come stringhe anziché come numeri. Quando non viene specificato alcun valore, restituiscono una stringa vuota anziché -1 o non definita. Inoltre, una volta impostata la larghezza o l'altezza, non è possibile annullare le modifiche senza aggiornare il browser, ma un valore vuoto verrà interpretato come una dimensione pari a 1.

In generale, le app basate su modello non vincolano l'altezza e la larghezza di un componente, quindi non è necessario tenere traccia delle dimensioni del contenitore. Al contrario, i componenti di codice possono aumentare fino a usare 100% dello spazio per i componenti della griglia o a un'altezza specifica richiesta dal contenuto durante il rendering di un field componente. Nelle app canvas, tuttavia, il contesto padre fornisce sempre l'altezza e la larghezza al componente per natura dell'editor di trascinamento della selezione.

La tabella seguente illustra le strategie che è possibile usare per controllare l'altezza e la larghezza dei controlli contenuti HTML:

Host	Tipo di componente del codice	Strategia di dimensioni altezza CSS	Strategia delle dimensioni della larghezza CSS
App basate su modello	dataset	height: "100%"	width: "100%"
App basate su modello	field	Aumentare fino a un'altezza massima (Il modulo di hosting crescerà anche per adattarsi).	width: "100%"
App basate su modello	field (modalità schermo intero)	height: "100%"	width: "100%"
App canvas	dataset & field	height: allocatedWidth	width: allocatedHeight
App canvas	dataset & field (modalità schermo intero)	height: "100%"	width: "100%"

Se i valori di allocatedWidth e allocatedHeight cambiano dopo la prima updateView chiamata, viene chiamato un successivo updateView con "layout" aggiunto a context.updatedProperties. Altre informazioni: UpdatedProperties.

Disponibile per

App basate su modello, app canvas e portali.

Sintassi

context.mode.trackContainerResize(value)

Parametri

Nome del parametro	TIPO	Obbligatorio	Description
value	Boolean	Yes	True se i controlli devono tenere traccia delle dimensioni del contenitore, il componente verrà allocatoWidth o allocateHeight.

Articoli correlati

Modalità
Informazioni di riferimento sulle API del framework dei componenti di Power Apps
Panoramica del framework dei componenti di Power Apps