コンポーネントが対応する必要がある場合に、コンテナーのサイズ設定を決定します。 入力が true の場合、コンポーネントは allocatedWidth または allocatedHeight を取得します。
trackContainerResize(true) メソッドを呼び出すと、コード コンポーネントのupdateView メソッド内にcontext.mode.allocatedWidthとcontext.mode.allocatedHeightが提供されます。 これらのプロパティの値は、コード コンポーネントがホストされている場所によって異なります。
-1の値は、コード コンポーネントが必要に応じて使用可能な領域を埋めるように CSS スタイルルールを設定できることを示します。
次の表は、ホストとコード コンポーネントのライフサイクル メソッドのさまざまな組み合わせにおける allocatedWidth と allocatedHeight の値を示しています。
| Host | Lifecycle メソッド | allocatedWidth |
allocatedHeight |
|---|---|---|---|
| モデル駆動型アプリとキャンバス アプリ | init |
-1 | -1 |
| モデル駆動型アプリ | updateView |
trackContainerResize(false)または場合は -1幅 (ピクセル単位) trackContainerResize(true)ブラウザー ウィンドウのサイズが変更され、フォームが使用可能な領域に合わせて調整されると、幅が変更されます。 |
-1 |
| キャンバス アプリ | updateView |
アプリ 作成者によって設定されます。 幅が Power FX 数式に設定されている場合、動的に変更できます。 |
アプリ 作成者によって設定されます。 幅が Power FX 数式に設定されている場合、動的に変更できます。 |
注
テスト ハーネス ( npm start の使用を開始) では、 allocatedHeight と allocatedWidth は数値ではなく文字列として返されます。 値が指定されていない場合、-1 または未定義ではなく、空の文字列が返されます。 さらに、幅または高さを設定すると、ブラウザーを更新せずに変更を元に戻すことはできません。代わりに、空白の値は 1 のサイズとして解釈されます。
一般に、モデル駆動型アプリはコンポーネントの高さと幅を制限しないため、コンテナー のサイズを追跡する必要はありません。 代わりに、コード コンポーネントは、グリッド コンポーネントのスペースの 100% を使用するか、 field コンポーネントをレンダリングするときにコンテンツに必要な特定の高さに拡張できます。 ただし、キャンバス アプリでは、親コンテキストは、ドラッグ アンド ドロップ エディターの性質上、コンポーネントの高さと幅を常に提供します。
次の表は、コントロールの HTML コンテンツの高さと幅を制御するために使用できる戦略を示しています。
| Host | コード コンポーネントの種類 | 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の値が変更された場合、後続のupdateViewが呼び出され、context.updatedPropertiesに "layout" が追加されます。 詳細情報: UpdatedProperties。
使用できる対象
モデル駆動型アプリ、キャンバス アプリ、ポータル。
構文
context.mode.trackContainerResize(value)
パラメーター
| パラメーター名 | タイプ | 必須 | Description |
|---|---|---|---|
| value | Boolean |
イエス |
True コントロールがコンテナー サイズを追跡する必要がある場合、コンポーネントは allocatedWidth または allocatedHeight を取得します。 |
関連資料
モード
Power Apps コンポーネント フレームワーク API リファレンス
Power Apps コンポーネント フレームワークの概要