SFZTableView クラスの仕様

SFZTableView クラスは、 テーブルモデル（SFOTableModel）を表形式で操作するためのレスポンダです。

テーブルビュー（SFZTableView）は、 テーブルビューに表示する列の数だけのテーブルビューカラム（SFOTableViewColumn） とテーブルセルリアクター（SFOTableCellReactor）から構成されます。

テーブルビューカラムはテーブルビューの列を表し、 テーブルビューカラムはタイトルを表示するためのヘッダーとデータを表示・編集するためのテーブルセル（セル）から構成されます。

テーブルビューカラムにテーブルモデル（SFOTableModel）の列データであるテーブルモデルカラムを関連付けることにより、 テーブルビューは表形式でテーブルモデルのデータを表示したり編集することが可能になります。

SFZTableView / SFOTableViewColumn / SFOTableCellReactor クラスは、 それぞれテーブルビューの描画とキー処理、ヘッダーの描画、セルの描画とセル選択時の処理を行います。

テーブルモデル

テーブルモデル（SFOTableModel）は、 表形式のテーブルビュー（SFZTableView）に表示するデータのことで、 テーブルモデルとテーブルビューは互いに独立した存在になっています。

テーブルモデルは、 項目[行]（SFXTableItemBase）の可変長配列（SFXArray）として表されます。

項目[行]は、 サイズがテーブルモデルカラム数（NUM）である、 セルオブジェクト（SFXAny）の固定長配列（SFXArray）として表されます。

※ テーブルモデルカラム数とは、テーブルモデルの列の数のことです。 テーブルモデルでは、列数は固定長、行数は可変長です。

テーブルモデルへのテーブルビューとテーブルビューカラムの関連付け

テーブルモデルは、 テーブルビューに関連付けることにより表形式でその内容を表示したり編集することが可能になります。

テーブルビューカラムは、テーブルビューの列を表します。

テーブルビューカラムには、 テーブルモデルカラムと呼ぶテーブルモデルの列を関連付けます。

テーブルビューカラムとテーブルセルリアクターの関係

1 つのテーブルビューカラム（SFOTableViewColumn）付き 1 つのテーブルセルリアクター（SFOTableCellReactor）が必要になります。

デフォルトの具象テーブルセルリアクタークラスとして SFOTableCellTextReactor / SFOTableCellToggleReactor / SFOTableCellImageReactor クラスが提供されます。 テーブルビューの列単位で型は同じになりますが、 テーブルビューのセルにはテキスト、チェックボックス、画像を表示できます。 テキストとチェックボックスのセルは編集することも可能です。

SFZTableView / SFOTableViewColumn / SFOTableCellReactor の階層プロパティ

SFZTableView、 SFOTableViewColumn、 SFOTableCellReactor の各クラスは、内部に階層プロパティ （SFXHierarchyProperty）を保持しています。

これらの階層プロパティの間には、

SFZTableView のプロパティ → SFOTableViewColumn のプロパティ → SFOTableCellReactor のプロパティ

というプロパティの親子関係（継承関係）が存在します。 子プロパティに存在しない属性は親プロパティから継承し、 親プロパティの属性を子プロパティでオーバーライドすることが可能です。

階層プロパティの継承機能は、 テーブルビュー全体で定義したある属性について特定の列のヘッダーやセルにおいてだけ変更したい場合に利用できます。

プロパティの属性

階層プロパティ（SFXHierarchyProperty）は、 属性キーと属性値のマップから構成され、 属性キーは前景色やテキストのフォントといった様々な属性の種類を表します（参照: 以下の表「SFZTableView / SFOTableViewColumn / SFOTableCellReactor のプロパティ」）。

SFZTableView / SFOTableViewColumn / SFOTableCellReactor / SFOTableCellTextReactor / SFOTableCellToggleReactor / SFOTableCellImageReactor クラスが内部に保持する、 階層プロパティ（SFXHierarchyProperty）の内容は以下の表にある通りです。

□サンプルコード

詳細なコードは、 こちら（mvcfactory.zip）を参照してください。

Void UserAppClass::Main(Void)
{
    static ACharConst                           marks[][16] = {
        "sun",
        "cloud",
        "snowman",
        "star",
        "white star",
        "telephone",
        "spade",
        "heart",
        "diamond",
        "club",
        "quaver",
        "semiquaver"
    };
    SFZScrollBarControlSmp                      bar;
    SFZTableViewSmp                             view;
    SFOTableModelSmp                            model;
    SFOTableViewColumnSmp                       vcol;
    SFOTableCellReactorSmp                      rtor;
    SFXTableItem<3>                             item;
    SFBImageSmp                                 icon[12];

    // ■■■ テーブルビューの作成 ■■■ 

    view = SFZTableView::NewInstance();

    view->SetParent(GetThis());
    view->SetRealBound(GetLocalBound().Deflate(5, 5, 10, 5));
    view->SetState(true, true, true, true);

    // 行の高さを 24 に設定する
    view->SetItemHeight(24);

    // 横向きにカーソルをループする
    view->SetXLoop(true);

    // 縦向きにカーソルをループする
    view->SetYLoop(true);

    // スクロールバーを生成する
    bar = SFZScrollBarControl::NewInstance();

    bar->SetParent(GetThis());
    SFXRectangle bound(view->GetRealBound());
    bar->SetRealBound(bound.AddX(bound.GetWidth()).SetWidth(5));
    bar->SetState(true, true, false, false);

    // テーブルビューにスクロールバーを設定する
    view->SetScrollBarControl(bar);

    // ■■■ テーブルモデルの作成 ■■■ 

    // テーブルモデルを生成する
    model = SFOTableModel::NewInstance();

    // アイコン画像をリソースファイルから取得する
    for (SInt16 i = 0; i < 12; i++) {
        icon[i] = SFBShell::GetInstance()->LoadResImage("userapp.bar", IDI_OBJECT_5001 + i);
    }

    // アイテムに各テーブルモデルカラムのデータをセットして追加する
    for (SInt32 row = 0; row < 60; ++row) {
        item.data[0] = SFXAnsiString(marks[row % 12]);
        item.data[1] = icon[row % 12];
        item.data[2] = static_cast<Bool>(row % 2);
        model->InsertLast(item);
    }

    // ■■■ テーブルビューとテーブルモデルの関連付け ■■■ 

    view->SetModel(model);

    // ■■■ 第 1 列目のテーブルビューカラムの作成 ■■■ 

    // テーブルセルトグルリアクターを作成する
    rtor = SFOTableCellToggleReactor::NewInstance();

    // 編集可に設定する
    rtor->SetProperty(SFLPROP_EDITABLE, true);

    // 第 3 列目のテーブルモデルカラム（Bool 型）と関連付ける: ヘッダーのタイトルは "（空文字列）
    vcol = SFOTableViewColumn::NewInstance(", 2, rtor);

    // 固定幅 24 に設定する
    vcol->SetProperty(SFLPROP_FIXED_WIDTH, 24);

    // テーブルビューにテーブルビューカラムを追加する
    view->AddColumn(vcol);

    // ■■■ 第 2 列目のテーブルビューカラムの作成 ■■■ 

    // イメージセルテキストリアクターを作成する
    rtor = SFOTableCellImageReactor::NewInstance();

    // 第 2 列目のテーブルモデルカラム（SFBImageSmp 型）と関連付ける: ヘッダーのタイトルは "（空文字列）
    vcol = SFOTableViewColumn::NewInstance(", 1, rtor);

    // 固定幅を 24 に設定する
    vcol->SetProperty(SFLPROP_FIXED_WIDTH, 24);

    // テーブルビューにテーブルビューカラムを追加する
    view->AddColumn(vcol);

    // ■■■ 第 3 列目のテーブルビューカラムの作成 ■■■ 

    // テーブルセルテキストリアクターを作成する
    rtor = SFOTableCellTextReactor::NewInstance();
    // 編集可に設定する
    rtor->SetProperty(SFLPROP_EDITABLE, true);

    // 第 1 列目のテーブルモデルカラム（SFXAnsiString 型）と関連付ける: ヘッダーのタイトルは "marks" 
    vcol = SFOTableViewColumn::NewInstance("marks", 0, rtor);

    // アライメントを左詰めに設定する
    vcol->SetProperty(SFLPROP_ALIGNMENT, IDF_ALIGN_LEFT | IDF_ALIGN_MIDDLE);

    // テーブルビューにテーブルビューカラムを追加する
    view->AddColumn(vcol);

    return;
}