Share via

trackContainerResize

  • Artikel

Bestimmt die Containergrößenanpassung, wenn die Komponente reagieren muss. Die Komponente ruft allocatedWidth oder allocatedHeight ab, wenn die Eingabe true ist..

Wenn Sie die trackContainerResize(true)-Methode aufrufen, werden die context.mode.allocatedWidth und context.mode.allocatedHeight in der updateView-Methode der Codekomponente bereitgestellt. Die Werte dieser Eigenschaften unterscheiden sich je nachdem, wo die Codekomponente gehostet wird. Ein Wert von -1 bedeutet, dass die Codekomponente CSS-Stilregeln festlegen kann, um den verfügbaren Platz nach Bedarf zu füllen.

Die folgende Tabelle zeigt die Werte von allocatedWidth und allocatedHeight in den verschiedenen Kombinationen von Host- und Codekomponenten-Lebenszyklusmethoden an.

Host Lebenszyklusmethode allocatedWidth allocatedHeight
Modellgesteuerte und Canvas-Apps init -1 -1
Modellgesteuerte Apps updateView -1 wenn trackContainerResize(false) oder
Breite in Pixeln wenn trackContainerResize(true)
Die Breite ändert sich, wenn die Größe des Browserfensters geändert wird und das Formular an den verfügbaren Platz angepasst wird.		 -1
Canvas-Apps updateView Von der die App erstellenden Person festgelegt.
Kann sich dynamisch ändern, wenn die Breite auf eine Power Fx-Formel eingestellt ist.		 Von der die App erstellenden Person festgelegt.
Kann sich dynamisch ändern, wenn die Breite auf eine Power Fx-Formel eingestellt ist.

Hinweis

In der Testumgebung (Einsatz von npm start begonnen) werden die allocatedHeight und allocatedWidth als Zeichenfolgen und nicht als Zahlen zurückgegeben. Wenn kein Wert angegeben wird, wird eine leere Zeichenfolge anstelle von „-1“ oder „undefiniert“ zurückgegeben. Außerdem können Sie nach dem Festlegen der Breite oder Höhe die Änderungen nicht mehr rückgängig machen, ohne den Browser zu aktualisieren. Stattdessen wird ein leerer Wert als Größe 1 interpretiert.

Im Allgemeinen beschränken modellgesteuerte Apps die Höhe und Breite einer Komponente nicht, sodass die Verfolgung der Containergröße nicht erforderlich ist. Stattdessen können die Codekomponenten wachsen, um entweder 100 % des Platzes für Rasterkomponenten oder bis zu einer bestimmten Höhe zu verwenden, welche die Inhalte beim Rendern field-Komponente benötigen. In Canvas-Apps stellt der übergeordnete Kontext aufgrund des Drag-and-Drop-Editors jedoch immer die Höhe und Breite zur Komponente zur Verfügung.

Die folgende Tabelle zeigt die Strategien, mit denen Sie die Höhe und Breite der HTML-Inhalte Ihrer Steuerelemente steuern können:

Host Codekomponententyp CSS-Strategie für die Höhe CSS-Strategie für die Breite
Modellgesteuerte Apps dataset height: "100%" width: "100%"
Modellgesteuerte Apps field Anstieg bis zu einer maximalen Höhe
(Das Hosting-Formular steigt auch an.)		 width: "100%"
Modellgesteuerte Apps field (Vollbildmodus) height: "100%" width: "100%"
Canvas-Apps dataset & field height: allocatedWidth width: allocatedHeight
Canvas-Apps dataset & field (Vollbildmodus) height: "100%" width: "100%"

Wenn sich die Werte von allocatedWidth und allocatedHeight nach dem ersten updateView-Aufruf ändern, wird ein nachfolgender updateView aufgerufen, dem „Layout“ zu den context.updatedProperties hinzugefügt ist. Weitere Informationen: UpdatedProperties.

Verfügbar für

Modellgesteuerte Apps, Canvas-Apps und Portale.

Syntax

context.mode.trackContainerResize(value)

Parameter

Parametername Type Erforderlich Beschreibung des Dataflows
Wert Boolean Ja True, wenn Steuerelemente die Containergröße nachverfolgen müssen, ruft die Komponente allocatedWidth oder allocatedHeight ab.

Mode
Power Apps component framework-API-Referenz
Power Apps component framework Übersicht

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).