プロパティテーブルコンポーネント

プロパティテーブルコンポーネントについて

プロパティテーブルコンポーネントは、オブジェクトのプロパティ名/プロパティ値のペアをテーブルに表示します。次の例では、figloop-tutorial レポートのプロパティテーブルを説明します。

次のように、さまざまなタイプのプロパティテーブルコンポーネントを利用できます。

MATLAB^® プロパティテーブル
Simulink^® プロパティテーブル (Simulink Report Generator™ が必要)
Stateflow^® プロパティテーブル (Simulink Report Generator が必要)

この例で使用するコンポーネントは、MATLAB Report Generator プロパティテーブルコンポーネントです。このコンポーネントはすべて似たような動作を示します。

サンプルレポートテンプレートを開く

この例では、figloop-tutorial レポートテンプレートを使用します。Figure ループチュートリアルのレポートテンプレートを開くには、MATLAB コマンドラインで以下を入力します。

次のコマンドを実行して、この例で使用されているサポートファイルにアクセスします。
```
openExample('rptgen/MatlabReportGeneratorSupportFilesExample');
```
MATLAB コマンドプロンプトで、次のように入力します。
```
setedit figloop-tutorial
```

プロパティテーブル出力の確認

すべてのプロパティテーブルコンポーネントのプロパティページは形式が似ています。アウトラインペインで [Figure プロパティテーブル] コンポーネントを選択します。テーブル設定を変更するには、[Handle Graphics^® プロパティテーブル] ダイアログボックスで、[編集...] ボタンをクリックします。

オブジェクトタイプの選択

プロパティテーブルコンポーネントには、レポート対象として複数のオブジェクトタイプが用意されています。たとえば、Handle Graphics プロパティテーブルを使用すると、figure オブジェクト、axes オブジェクトまたは Handle Graphics オブジェクトについてレポートできます。

このコンポーネントのプロパティペインの [オブジェクトタイプ] リストから、レポート対象として別のオブジェクトタイプを選択できます。

プロパティ名/プロパティ値のペアの表示

プロパティ/値のセルの分割

Handle Graphics プロパティテーブルコンポーネントのプロパティペインで、[プロパティ/値のセルを分割] チェックボックスをオフにします。
[編集] をクリックします。テーブルは "非分割モード" になっています。非分割モードでは、セルおよびテキストごとに 1 を超えるプロパティ名/プロパティ値のペアがサポートされます。
テーブル内の水平方向に隣接するセルにプロパティ名とプロパティ値を表示するには、[プロパティ/値のセルを分割] チェックボックスをオンにします。テーブルは "分割モード" になります。分割モードでは、セルごとにプロパティ名/プロパティ値のペアを 1 つのみサポートします。1 を超えるプロパティのペアが 1 つのセルに表示されていても、レポートでは最初のペアのみが表示され、後続のペアはすべて無視されます。

表示オプション

プロパティ名とプロパティ値のペアは複数の方法でセルに表示できます。特定のプロパティ名/プロパティ値のペアをセルに表示する方法を指定するには、テーブルでそのフィールドを選択します (このチュートリアルでは、[Name] プロパティを選択します)。ダイアログボックスの下部にある表示オプションのドロップダウンリストから [Value] を選択します。選択したテーブル行には、その値のみが表示されます。

書式オプション

特定のセルのテキストの整列を指定するには、ダイアログボックスの下部のツールバーにある 4 つの行揃えボタンを使用します。

HandleVisibility テーブル行を選択します。次に、両端揃えボタン (一番右側のボタン) を選択します。

テーブルのタイトルの編集

テーブルのタイトルにはプロパティとテキストを含めることができます。既定では、テーブルのタイトルは %<Name> プロパティの値と同じです。このプロパティを変更することで、テーブルタイトルを変更できます。

メモ

テーブルタイトルは常に非分割モードです。

テーブルセルにテキストを入力

テキストを表示するには、テーブルを非分割モードにしなければなりません。[プロパティ/値のセルを分割] をオフにします。

HandleVisibility テーブルセルにテキストを入力するには、セルをダブルクリックします。セルプロパティのラベルをもつグレーのボックスが表示されます。

山かっこの外側にテキストを入力した場合、そのテキストがそのままレポートに表示されます。山かっこ内のテキストには有効なプロパティ名を指定しなければなりません。無効なプロパティ名を入力した場合、プロパティ値のないプロパティ名がレポートに表示されます。

テーブルのプロパティの追加、置換および削除

テーブルプロパティの追加

Handle Graphics プロパティをテーブルに追加するには、次の手順に従います。

[Figure プロパティテーブル] ウィンドウで、行の上に新しいプロパティを追加するテーブル行を選択します。
[現在のセルの上側に行を追加] ボタンをクリックします。
現在の行の上に新しい行が表示されます。
新しいテーブル行にプロパティを追加します。
1. 新しいテーブル行を選択します。
2. ダイアログボックスの右上にあるプロパティタイプのドロップダウンリストで、プロパティタイプを選択します。
3. [プロパティ] リストから、追加するプロパティを選択します。
4. [<< 追加] ボタンをクリックするか、プロパティ名をダブルクリックします。プロパティがテーブル行に表示されます。
あるいは、追加するプロパティ名が既知の場合、テーブルセルにテキストを入力の説明に従ってプロパティ名をセルに直接入力します。新しいテーブル行の追加の詳細については、列と行の追加と削除を参照してください。

テーブルプロパティの置換

分割モードでテーブルのセルのプロパティを置き換えるには、テーブルプロパティの追加の指示に従います。

メモ

テーブルが非分割モードの場合、これらの手順を使用してセルのプロパティを削除することはできません。

テーブルプロパティの削除

プロパティを削除するには、その上で Backspace キーを押すか、または Delete キーを使用します。

テーブルの列、行、セルの書式設定

列と行の追加と削除

列または行を追加または削除するには、セルを選択し、次の表で説明するいずれかのボタンをクリックします。

メモ

テーブル内に行または列が 1 つしかない場合、その行と列は削除できません。

ボタン	アクション
	列を追加 (選択した列の左側に追加されます)
	選択した列を削除
	行を追加 (選択した行の上に追加されます)
	選択した行を削除

列のサイズ変更

列幅のサイズを変更するには、垂直方向の境界をクリックして必要に応じてドラッグします。

セルの結合と分割

テーブルセルを結合または分割するには、行をクリックし、次の表で説明するいずれかのボタンをクリックします。

ボタン	アクション
	セルを下方向に結合
	セルを右方向に結合
	セルを分割

セルの境界の表示または非表示

セルの境界のオン/オフを切り替える方法は以下です。

カーソルをセル内に置き、右クリックしてコンテキストメニューを呼び出します。
[セルの境界] 、 [上]、[下]、[右] または [左] を選択し、指定した境界線のオン/オフを切り替えます。

ズームとスクロール

水平スクロールバーの左側に配置されているズームボタンを使用して、テーブルをズームインおよびズームアウトできます。

ボタン	アクション
	ズームイン
	ズームアウト

テーブルのスクロールバーを使用して、垂直方向および水平方向にスクロールできます。

テーブルの選択

プロパティ名/プロパティ値のペアを表示するには、プリセットテーブルを選択するか、カスタムテーブルを使用します。

プリセットテーブルは組み込みで、書式設定済みです。[Figure プロパティテーブル] ウィンドウの左上にある [プリセットテーブルの選択] リストからプリセットテーブルを選択できます。プリセットテーブルを適用するには、テーブルを選択し、[適用] をクリックします。
カスタムテーブルを作成するには、プリセットテーブルを選択し、行やプロパティを追加/削除してニーズに適合するように変更します。[Blank 4x4] プリセットテーブルから始めてみてください。
メモ
カスタムテーブルをプリセットテーブルとして保存することはできません。これを行った場合、カスタムテーブルに対するすべての変更内容が失われます。