trackContainerResize

Avgör storleken på containern om komponenten behöver reagera. Komponenten får allocatedWidth eller allocatedHeight om indata är sanna..

När du anropar trackContainerResize(true) metoden context.mode.allocatedWidth anges och context.mode.allocatedHeight i updateView -metoden för kodkomponenten. Värdena för dessa egenskaper skiljer sig beroende på var kodkomponenten finns. -1 Värdet anger att kodkomponenten kan ange CSS-formatregler för att fylla det tillgängliga utrymmet efter behov.

I följande tabell visas värdena allocatedWidth för och allocatedHeight i de olika kombinationerna av livscykelmetoder för värd- och kodkomponenter.

Host Livscykelmetod allocatedWidth allocatedHeight
Modelldrivna appar och appar för arbetsytor init -1 -1
Modellbaserade program updateView -1 om trackContainerResize(false) eller
bredd i bildpunkter om trackContainerResize(true)
Bredden ändras när webbläsarfönstret ändras och formuläret justeras till det tillgängliga utrymmet.
-1
Arbetsyteappar updateView Anges av apputvecklaren.
Kan ändras dynamiskt om bredden är inställd på en Power FX-formel.
Anges av apputvecklaren.
Kan ändras dynamiskt om bredden är inställd på en Power FX-formel.

Anmärkning

I testselen (började använda npm start) allocatedHeight returneras och allocatedWidth som strängar i stället för tal. När inget värde anges returnerar de en tom sträng i stället för -1 eller odefinierat. När bredden eller höjden har angetts kan du dessutom inte ångra ändringarna utan att uppdatera webbläsaren. I stället tolkas ett tomt värde som en storlek på 1.

I allmänhet begränsar inte modelldrivna appar höjden och bredden på en komponent, så det är inte nödvändigt att spåra containerstorleken. I stället kan kodkomponenterna växa till att antingen använda 100% av utrymmet för rutnätskomponenter eller till en viss höjd som krävs av innehållet när en field komponent återges. I appar för arbetsytor ger dock den överordnade kontexten alltid komponentens höjd och bredd efter drag-och-släpp-redigerarens natur.

I följande tabell visas de strategier som du kan använda för att styra höjden och bredden på html-innehållet i kontrollerna:

Host Kodkomponenttyp Strategi för CSS-höjdstorlek Strategi för CSS-breddstorlek
Modellbaserade program dataset height: "100%" width: "100%"
Modellbaserade program field Växa upp till en maximal höjd
(Värdformuläret kommer också att växa för att rymma).
width: "100%"
Modellbaserade program field (helskärmsläge) height: "100%" width: "100%"
Arbetsyteappar dataset & field height: allocatedWidth width: allocatedHeight
Arbetsyteappar dataset & field (helskärmsläge) height: "100%" width: "100%"

Om värdena allocatedWidth för och allocatedHeight ändras efter att den första updateView anropas anropas en efterföljande updateView med "layout" som läggs till i context.updatedProperties. Mer information: UpdatedProperties.

Tillgänglig för

Modelldrivna appar, arbetsyteappar och portaler.

Syntax

context.mode.trackContainerResize(value)

Parameterar

Parameternamn Typ Krävs Description
värde Boolean Yes True Om kontroller behöver spåra containerstorleken allokeras komponentenWidth eller allokerasHeight.

Läge
Api-referens för Power Apps-komponentramverket
Översikt över Power Apps-komponentramverk