リストビュー

概要

エクスプローラのファイル一覧のような一覧表を作るための部品です。

リストビューには、アイコン付きの項目を表示することが可能で、詳細表示では見出し(カラム)を表示することもできます。

生成可能ウィンドウ部品

継承する種類

ウィンドウ部品

必要プラグイン

ウィンドウ部品集(Produire.WinControl.dll

関係図

 

作成する方法

【名前】というリストビューを作る

 

手順

部品から継承される手順のほか、次の手順が使用できます。

クリアする すべて消す 加える 一括追加する 挟む 消す 探す 編集する 更新開始する 更新終了する 昇順に並び替える 降順に並び替える 

【自分】をクリアする

項目をすべて削除します

【自分】をすべて消す

項目をすべて削除します

【自分】へ〈【名前】という〉〈【内容】を〉〈【アイコン/画像】で〉加えるリストビュー項目

リストビューへ項目を追加します

【自分】へ【項目:リストビュー項目】を加える

リストビューへ項目を追加します

【自分】へ【項目一覧:配列】を〈【アイコン/画像】で〉一括追加する

リストビューへ項目を一括で追加します

【自分】の【挿入位置】へ〈【名前】という〉〈【内容】を〉〈【アイコン/画像】で〉挟むリストビュー項目

指定した位置やリストビューの項目を挿入します

【自分】の【挿入位置】へ【項目:リストビュー項目】を挟む

指定した位置やリストビューの項目を挿入します

【名前/番号】を消す

指定した項目を消します

【自分】から【内容】を探す

項目から指定した見出しを探します

【自分】を編集する

項目の見出しを編集します

【自分】を更新開始する

項目の操作を行うために一時的に描画を抑制します

【自分】を更新終了する

「変更開始」手順で一時的に停止した描画の抑制を解除します

【自分】を昇順に並び替える

項目を昇順に並び替えます

【自分】を降順に並び替える

項目を降順に並び替えます

設定項目

部品から継承される設定項目のほか、次の設定項目が使用できます。

設定項目   説明
表示方法 列挙体 リストビューの表示方法
小さいアイコン・大きいアイコン・一覧・詳細・縮小版(WindowsXPのみ)
チェックボックス 真偽値 チェックボックスを表示するかどうか
チェック項目一覧 リストビュー項目の配列 チェックボックスが表示されている場合、チェックしている項目の一覧(配列形式)
チェック番号一覧 整数の配列 チェックボックスが表示されている場合、チェックしている項目の番号一覧(配列形式)
個数 整数 項目の個数を表します
選択項目 リストビュー項目 選択している項目
選択内容 文字列 選択している項目の内容
選択番号 整数 選択している項目の整理番号
選択項目一覧 リストビュー項目の配列 複数選択している場合、選択している項目の一覧(配列形式)
選択番号一覧 整数の配列 複数選択している場合、選択している項目の番号一覧(配列形式)
選択数 整数 複数選択している場合、選択している項目の個数
文字色 色情報 文字の色
背景色 色情報 背景の色
全列選択 真偽値 詳細表示の場合に、項目を選択した際にすべての列を選択状態にするかどうか
罫線 真偽値 仕切り線を表示するかどうか
選択表示 真偽値 別のオブジェクトにカーソルが移動した際にも選択状態を表示しつづけるかどうか
自動選択 真偽値 マウスカーソルを置くだけで、自動的に項目が選択できるようにするかどうか
ラベル編集 真偽値 項目の名称を編集できるようにするかどうか
ラベル折り返し 真偽値 アイコン表示の場合、項目名が収まりきらない場合に折り返すかどうか
複数選択 真偽値 項目を複数選択できるようにするかどうか
項目一覧 リストビュー項目の配列 表示する項目(配列形式)
一覧 文字列の配列 表示する項目(配列形式)
見出し一覧 文字列の配列 詳細表示の場合に、上部に表示する見出し(カラム)の一覧(配列形式)
詳細一覧 文字列の配列の配列 詳細表示の場合に、表示される詳細情報を含む、項目のすべての内容(2次配列)
透明色 色情報 アイコンを指定した際に、透明扱いとする色

記号の意味

イベント手順

部品から継承されるイベント手順のほか、次のイベント手順が使用できます。

イベント名 説明 イベント情報
ドラッグされた 項目をドラッグされた時 あり
仮想検索が開始された 仮想検索が開始された時
仮想項目が必要になった 仮想項目が必要になった時 あり
仮想項目の状態が変化した 仮想項目の状態が変化した時
仮想表示領域が変化した 仮想表示領域が変化した時
見出しがクリックされた 見出しがクリックされた時 あり
見出しの順序が変更された 見出しの順序が変更された時
見出しの幅が変更された 見出しの幅が変更された時
見出しの幅が変更される 見出しの幅が変更される直前
項目をチェックする 項目がチェックする直前
項目がチェックされた 項目がチェックされた直後
項目がポイントされた 項目にマウスカーソルがポイントされた
項目が選択された 項目が選択された時
選択された 選択された時
(選択時と選択解除時それぞれで実行されます)
選択項目が変更された 項目が選択された時
ラベルが変更された 項目の見出しを編集された直後 あり
ラベルが変更される 項目の見出しを編集する直前 あり

 

プログラム例

リストビューに項目を追加する例です。

ファイルアイコンは、「shell32.dll」の1番目からアイコン画像を抽出したもの
メイン画面を表示する
待機する

メイン画面とは
  ウィンドウを継承する
  はじめの手順
    初期化する
    ーー貼り付けた部品に対する操作をここに書きます
    リストビュー1に「お知らせ.txt」をファイルアイコンで追加する
      その詳細を{「9月10日」、「テキストファイル」}に変える
    リストビュー1に「計画.ppt」をファイルアイコンで追加する
      その詳細を{「9月1日」、「PowerPointスライド」}に変える
    リストビュー1に「レポート.doc」をファイルアイコンで追加する
      その詳細を{「9月15日」、「Wordドキュメント」}に変える

    選択リスト1の番号を0に変える
  終わり
  初期化する手順
  ーー自動生成された手順です。ここにプログラムを書き加えても消える場合があります
  この設計スケール比率を{144,144}に変える
  この内部領域大きさを{400,300}に変える
  この内容を「リストビューのサンプル」に変える
  選択リスト1という選択リストを作る
    その位置と大きさを{12,12,150,26}に変える
    その入力可能を×に変える
    その選択窓幅を150に変える
    その項目高さを18に変える
    その一覧を{「大きいアイコン」,「小さいアイコン」,「一覧」,「詳細」,「縮小版」}に変える
  リストビュー1というリストビューを作る
    その位置と大きさを{12,50,376,238}に変える
    その見出し一覧を{「ファイル名」,「更新日」,「種類」}に変える
    その見出し幅を{100,80,100}に変える
    そのタイルサイズを{200,45}に変える
    その移動順を1に変える
終わり
  リストビュー1がダブルクリックされた時の手順
    リストビュー1の選択内容を表示する
  終わり
  選択リスト1が選択された時の手順
    リストビュー1の表示方法を選択リスト1の内容に変える
  終わり
終わり