FolderView(ShellBrowser)リファレンス

Tablacus Explorer のファイルビュー(te.Ctrl(CTRL_FV) などで取得できる ShellBrowser オブジェクト)のリファレンスです。

• 以降、このオブジェクトを FV と表記します。
• 関連: te リファレンス、api リファレンス

記法: P=プロパティ(FV.Name で読み、FV.Name = v で書く)、M=メソッド(FV.Name(...))。 Columns / SortColumn / CurrentViewMode / FilterView のように、実装がプロパティ・メソッド両方に対応するものは「P/M」と表記します。

目次

1. 取得方法
2. ナビゲーション
3. 表示モード・設定
4. アイテムの取得・選択
5. 列・ソート・グループ・フィルタ
6. ウィンドウ・タブ・関連オブジェクト
7. アイテムの動的追加・削除(検索結果ビュー等)
8. カスタマイズ用プロパティ
9. 通知・内部用メソッド
10. 定数
11. 廃止・内部用

1. 取得方法

const FV = te.Ctrl(CTRL_FV);              // 現在のタブのビュー
const arFV = te.Ctrls(CTRL_FV, true);     // 表示中のビューすべて
const FV2 = te.CtrlFromWindow(hwnd);      // hwnd から
const FV3 = te.CtrlFromPoint(pt);         // 座標から

各イベント(OnBeforeNavigate など)の引数としても渡されます。

2. ナビゲーション

Navigate2 の引数順(第3引数以降):

FV.Navigate("C:\\Windows", SBSP_SAMEBROWSER);
FV.Navigate(null, SBSP_PARENT | SBSP_SAMEBROWSER);       // 上へ
FV.Navigate(null, SBSP_NAVIGATEBACK | SBSP_SAMEBROWSER); // 戻る
const newFV = FV.Navigate("C:\\", SBSP_NEWBROWSER);       // 新しいタブ

3. 表示モード・設定

4. アイテムの取得・選択

const items = FV.SelectedItems();
for (let i = 0; i < items.length; ++i) {
    const path = items[i].Path;
}
for (let i = 0; i < items.Count; ++i) {
    const path = items.Item(i).Path;
}
FV.SelectItem(FV.Item(0), SVSI_SELECT | SVSI_FOCUSED | SVSI_ENSUREVISIBLE | SVSI_DESELECTOTHERS);

5. 列・ソート・グループ・フィルタ

6. ウィンドウ・タブ・関連オブジェクト

7. アイテムの動的追加・削除(検索結果ビュー等)

検索結果フォルダなど、プログラムでアイテムを制御するビュー用です。

8. カスタマイズ用プロパティ

JavaScript のオブジェクトまたは関数を代入して、ビュー単位で動作を差し替えます。

9. 通知・内部用メソッド

10. 定数

consts.js で定義されているものを掲載します。

SBSP_*(Navigate のフラグ) SBSP_SAMEBROWSER = 1 / SBSP_NEWBROWSER = 2 / SBSP_OPENMODE = 0x10 / SBSP_EXPLOREMODE = 0x20 / SBSP_RELATIVE = 0x1000 / SBSP_PARENT = 0x2000 / SBSP_NAVIGATEBACK = 0x4000 / SBSP_NAVIGATEFORWARD = 0x8000 / SBSP_ACTIVATE_NOFOCUS = 0x80000 / SBSP_WRITENOHISTORY = 0x08000000

FVM_*(ビューモード) FVM_AUTO = -1 / FVM_ICON = 1 / FVM_SMALLICON = 2 / FVM_LIST = 3 / FVM_DETAILS = 4 / FVM_THUMBNAIL = 5 / FVM_TILE = 6 / FVM_THUMBSTRIP = 7

SVSI_*(SelectItem のフラグ) SVSI_DESELECT = 0 / SVSI_SELECT = 1 / SVSI_EDIT = 3 / SVSI_DESELECTOTHERS = 4 / SVSI_ENSUREVISIBLE = 8 / SVSI_FOCUSED = 0x10 / SVSI_TRANSLATEPT = 0x20 / SVSI_SELECTIONMARK = 0x40 / SVSI_POSITIONITEM = 0x80 / SVSI_CHECK = 0x100 / SVSI_CHECK2 = 0x200 / SVSI_KEYBOARDSELECT = 0x401 / SVSI_NOTAKEFOCUS = 0x40000000 / SVSI_NOSTATECHANGE = 0x80000000

SVGIO_*(Items/ItemCount/ViewMenu) SVGIO_BACKGROUND = 0 / SVGIO_SELECTION = 1 / SVGIO_ALLVIEW = 2 / SVGIO_CHECKED = 3 / SVGIO_TYPE_MASK = 0xf / SVGIO_FLAG_VIEWORDER = 0x80000000

その他の FWF_*、EBO_*、LVHT_*、LVIR_*、SHCNE_* も consts.js にあります。

Type の値: CTRL_SB = 1(ShellBrowser)/ CTRL_EB = 2(ExplorerBrowser)。te.Ctrl(CTRL_FV) はどちらのビューも返します。

11. 廃止・内部用

関連

• te リファレンス
• api リファレンス