TabCtrl リファレンス

Tablacus Explorer のタブコントロール(CTRL_TC)のリファレンスです。

• タブコントロールは、複数のファイルビュー(FolderView)をタブとして保持します。
• 取得方法: te.Ctrl(CTRL_TC)(現在のタブコントロール)、te.Ctrls(CTRL_TC)(全件)、FV.Parent(ビューの所属)、te.CreateCtrl(CTRL_TC, ...)(新規作成)。
• 関連: te リファレンス、api リファレンス、FolderView(ShellBrowser)リファレンス、FolderItems リファレンス、TreeView リファレンス

記法: P=プロパティ(TC.Name で読み、TC.Name = v で書く)、M=メソッド(TC.Name(...))。

目次

1. 取得方法
2. 基本・タブの取得
3. タブの選択・操作
4. 位置・サイズ・スタイル
5. 更新の制御
6. 定数
7. 使用例

1. 取得方法

const TC = te.Ctrl(CTRL_TC);            // 現在のタブコントロール
const arTC = te.Ctrls(CTRL_TC, true);   // 表示中のタブコントロールすべて
const TC2 = FV.Parent;                  // ビューの所属タブコントロール
const TC3 = te.CreateCtrl(CTRL_TC, Left, Top, Width, Height);  // 新規作成

te.CreateCtrl(CTRL_TC, ...) の引数は te リファレンス を参照してください。

2. 基本・タブの取得

for (let i = 0; i < TC.length; ++i) {
    const FV = TC[i];
}
for (let i = 0; i < TC.Count; ++i) {
    const FV = TC.Item(i);
}
for (const FV in TC) { /* ... */ }

3. タブの選択・操作

Selected は、現在選択中の位置のビューが未作成なら新しくビューを作って返します。副作用に注意してください。

4. 位置・サイズ・スタイル

• Align が 4 / 5 で TCS_SCROLLOPPOSITE のとき、自動的に TCS_BUTTONS が付加されます。TCS_BUTTONS 有効かつ Align が 2 より大きいときは TCS_BOTTOM が外れます。
• TCS_SCROLLOPPOSITE は、TCS_BUTTONS が有効、または TCS_MULTILINE が無効のとき無視されます。
• Left / Top / Width / Height / Style / Align / TabWidth / TabHeight の変更はすぐに再配置に反映されます。

TC.Left = "0%";
TC.Width = "50%";     // 画面の半分
TC.Align = 2;         // タブを上に
TC.TabHeight = 28;

5. 更新の制御

タブを大量に開く/閉じるときは、LockUpdate と UnlockUpdate で囲むと画面の更新が1回で済みます(メインウィンドウ全体の制御は te.LockUpdate)。

TC.LockUpdate();
try {
    for (const path in paths) {
        TC.Selected.Navigate(path, SBSP_NEWBROWSER);
    }
} finally {
    TC.UnlockUpdate();
}

6. 定数

consts.js で定義されています。

TCHT_*(HitTest の flags) TCHT_NOWHERE = 1 / TCHT_ONITEMICON = 2 / TCHT_ONITEMLABEL = 4 / TCHT_ONITEM = 6

TCS_*(Style) TCS_TABS = 0 / TCS_BUTTONS = 0x100 / TCS_SINGLELINE = 0 / TCS_MULTILINE = 0x200 / TCS_RIGHTJUSTIFY = 0 / TCS_FIXEDWIDTH = 0x400 / TCS_RAGGEDRIGHT = 0x800 / TCS_FOCUSONBUTTONDOWN = 0x1000 / TCS_OWNERDRAWFIXED = 0x2000 / TCS_TOOLTIPS = 0x4000 / TCS_FOCUSNEVER = 0x8000 / TCS_SCROLLOPPOSITE = 1 / TCS_BOTTOM = 2 / TCS_RIGHT = 2 / TCS_MULTISELECT = 4 / TCS_FLATBUTTONS = 8 / TCS_FORCEICONLEFT = 0x10 / TCS_FORCELABELLEFT = 0x20 / TCS_HOTTRACK = 0x40 / TCS_VERTICAL = 0x80

CTRL_TC CTRL_TC = 0x30000(Type が返す値)

7. 使用例

const TC = te.Ctrl(CTRL_TC);

// 全タブのパスを列挙
for (let i = 0; i < TC.length; ++i) {
    const FV = TC[i];
    const path = FV.FolderItem.Path;
}
// 全タブのパスを列挙2
for (let i = 0; i < TC.Count; ++i) {
    const FV = TC.Item(i);
    const path = FV.FolderItem.Path;
}

// 新しいタブで開く
const FV = TC.Selected.Navigate("C:\\Windows", SBSP_NEWBROWSER);

// タブを切り替える・移動する
TC.SelectedIndex = 0;
TC.Move(TC.Selected, 0);          // 選択中のタブを先頭へ

// 逆順に並べ替え
const order = [];
for (let i = TC.Count; i--;) {
    order.push(i);
}
TC.SetOrder(order);

// マウス位置のタブを取得 (flags 省略でビューが返る)
const pt = api.Memory("POINT");
api.GetCursorPos(pt);
const target = TC.HitTest(pt);
if (target) {
    target.Close();
}

関連

• te リファレンス
• api リファレンス
• FolderView(ShellBrowser)リファレンス
• FolderItems リファレンス
• TreeView リファレンス