trackContainerResize

Menentukan ukuran kontainer jika komponen perlu bereaksi. Komponen akan mendapatkan allocatedWidth atau allocatedHeight jika inputnya benar..

Ketika Anda memanggil trackContainerResize(true) metode , context.mode.allocatedWidth dan context.mode.allocatedHeight akan disediakan di dalam updateView metode komponen kode. Nilai properti ini berbeda tergantung di mana komponen kode dihosting. Nilai -1 menunjukkan bahwa komponen kode dapat mengatur aturan Gaya CSS untuk mengisi ruang yang tersedia sesuai kebutuhan.

Tabel berikut menunjukkan nilai allocatedWidth dan allocatedHeight dalam kombinasi metode siklus hidup komponen host dan kode yang berbeda.

Host	Metode Siklus Hidup	allocatedWidth	allocatedHeight
Aplikasi berbasis model dan kanvas	init	-1	-1
Aplikasi yang diarahkan model	updateView	-1 jika trackContainerResize(false) atau lebar dalam piksel jika trackContainerResize(true) Lebar akan berubah saat jendela browser diubah ukurannya dan formulir menyesuaikan dengan ruang yang tersedia.	-1
Aplikasi kanvas	updateView	Diatur oleh pembuat aplikasi. Dapat berubah secara dinamis jika lebar diatur ke rumus Power FX.	Diatur oleh pembuat aplikasi. Dapat berubah secara dinamis jika lebar diatur ke rumus Power FX.

Nota

Dalam harness pengujian (mulai menggunakan npm start), allocatedHeight dan allocatedWidth akan dikembalikan sebagai string daripada angka. Ketika tidak ada nilai yang disediakan, mereka akan mengembalikan string kosong daripada -1 atau tidak terdefinis. Selain itu, setelah lebar atau tinggi diatur, Anda tidak dapat membatalkan perubahan tanpa me-refresh browser, sebagai gantinya nilai kosong akan ditafsirkan sebagai ukuran 1.

Secara umum, aplikasi berbasis model tidak membatasi tinggi dan lebar komponen, sehingga melacak ukuran kontainer tidak diperlukan. Sebaliknya, komponen kode dapat tumbuh untuk menggunakan 100% ruang untuk komponen kisi, atau ke ketinggian tertentu yang diperlukan oleh konten saat merender field komponen. Namun, di aplikasi kanvas, konteks induk selalu menyediakan tinggi dan lebar untuk komponen berdasarkan sifat editor seret dan letakkan.

Tabel berikut ini memperlihatkan strategi yang bisa Anda gunakan untuk mengontrol tinggi dan lebar konten HTML kontrol Anda:

Host	Jenis Komponen Kode	Strategi Ukuran Tinggi CSS	Strategi Ukuran Lebar CSS
Aplikasi yang diarahkan model	dataset	height: "100%"	width: "100%"
Aplikasi yang diarahkan model	field	Tumbuh hingga ketinggian maksimum (Formulir hosting juga akan tumbuh untuk mengakomodasi).	width: "100%"
Aplikasi yang diarahkan model	field (mode layar penuh)	height: "100%"	width: "100%"
Aplikasi kanvas	dataset & field	height: allocatedWidth	width: allocatedHeight
Aplikasi kanvas	dataset & field (mode layar penuh)	height: "100%"	width: "100%"

Jika nilai allocatedWidth dan allocatedHeight berubah setelah yang pertama updateView dipanggil, maka updateView berikutnya dipanggil dengan "tata letak" ditambahkan ke context.updatedProperties. Informasi selengkapnya: UpdatedProperties.

Tersedia untuk

Aplikasi berbasis model, aplikasi kanvas, & portal.

Syntax

context.mode.trackContainerResize(value)

Parameter-parameternya

Nama Parameter	Tipe	Diperlukan	Description
value	Boolean	Yes	True jika kontrol perlu melacak ukuran kontainer, komponen akan mendapatkan allocatedWidth atau allocatedHeight.

Artikel terkait

Modus
Referensi API kerangka kerja komponen Power Apps
Gambaran umum kerangka kerja komponen Power Apps