trackContainerResize

コンポーネントが応答する必要がある場合にコンテナー サイズを決定します。 入力が true の場合に、コンポーネントは allocatedWidth または allocatedHeight を取得します。.

trackContainerResize(true) メソッドを呼び出すと、context.mode.allocatedWidth と context.mode.allocatedHeight はコードコンポーネントの updateView メソッド内で提供されます。 これらのプロパティの値は、コード コンポーネントがホストされている場所によって異なります。 -1 の値は、コードコンポーネントが CSS のスタイル ルールを設定して、必要に応じて利用可能なスペースを埋めることができることを示します。

次の表は、ホストとコード コンポーネントのライフサイクル メソッドの異なる組み合わせにおける allocatedWidth と allocatedHeight の値を示しています。

ホスト	ライフサイクル方式	allocatedWidth	allocatedHeight
モデル駆動型アプリとキャンバス アプリ	init	-1	-1
モデル駆動型アプリ	updateView	-1 if trackContainerResize(false) または 最大幅 ピクセル if trackContainerResize(true) 横幅は、ブラウザのウィンドウ サイズを変更すると、空きスペースに合わせてフォームが変化します。	-1
キャンバス アプリ	updateView	アプリ開発者が設定します。 幅が Power FX の数式に設定されている場合、動的に変更することができます。	アプリ開発者が設定します。 幅が Power FX の数式に設定されている場合、動的に変更することができます。

注意

テスト ハーネス内 (npm start を使用して開始)、allocatedHeight、allocatedWidth は数値ではなく文字列として返されます。 値が指定されていない場合は、-1 や未定義ではなく、空の文字列を返します。 また、一度幅や高さを設定すると、ブラウザを更新しない限り変更を元に戻すことはできません。代わりに、空白の値はサイズ 1 として解釈されます。

一般的にモデル駆動型のアプリでは、コンポーネントの高さや幅に制約がないため、コンテナのサイズを追跡する必要はありません。 その代わり、コード コンポーネントは、グリッド コンポーネントの場合には 100% のスペースを使用し、field コンポーネントのレンダリング時にはコンテンツが必要とする特定の高さまで拡張することができます。 ただし、キャンバス アプリでは、ドラッグ アンド ドロップ エディターの性質上、親コンテキストが常にコンポーネントに高さと幅を提供します。

以下の表は、コントロールの HTML コンテンツの高さと幅を制御に使用できるストラテジーです。

ホスト	コード コンポーネントの種類	CSS 高さのサイズ ストラテジー	CSS 幅のサイズ ストラテジー
モデル駆動型アプリ	dataset	height: "100%"	width: "100%"
モデル駆動型アプリ	field	最大の高さまで拡張する (ホスティング フォームも対応して拡張します)。	width: "100%"
モデル駆動型アプリ	field (全画面表示モード)	height: "100%"	width: "100%"
キャンバス アプリ	dataset & field	height: allocatedWidth	width: allocatedHeight
キャンバス アプリ	dataset & field (全画面表示モード)	height: "100%"	width: "100%"

最初の updateView を呼び出した後、allocatedWidth と allocatedHeight の値が変化した場合は、context.updatedProperties に 「レイアウト」 を追加した後続の updateView が呼び出されます。 詳細については、UpdatedProperties を参照してください。

以下に使用できます

モデル駆動型アプリ、キャンバス アプリ、& ポータル。

構文

context.mode.trackContainerResize(value)

パラメーター

パラメーター名	タイプ	必須	説明
値	Boolean	はい	True コントロールがコンテナのサイズを追跡する必要がある場合、コンポーネントは allocatedWidth または allocatedHeight を取得します。

関連記事

Mode
Power Apps Component Framework API の参照
Power Apps Component Framework の概要

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。