CMFCBaseTabCtrl クラス
タブ付きウィンドウの基本的な機能を実装します。
class CMFCBaseTabCtrl : public CWnd
メンバー
パブリック メソッド
[名前] |
説明 |
|---|---|
|
|
タブ付きウィンドウに新しいタブを追加します。 |
|
|
|
|
|
|
|
|
|
|
|
タブ付きウィンドウからタブを切り離します。 |
|
|
|
タブの自動色指定を有効または無効にします。 |
|
タブのカスタム ツール ヒントを有効または無効にします。 |
|
タブ ラベルの直接編集を有効または無効にします。 |
|
デタッチできるタブを有効にします。 |
|
ユーザーの、マウスによるタブ オーダーの変更を有効または無効にします。 |
|
指定したタブが表示されるまでタブをスクロールします。 指定されたタブが既に表示されている場合、このメソッドは無効です。 |
|
|
|
指定した点を含むペインを返します。 |
|
|
|
|
|
アクティブなタブのインデックスを返します。 |
|
アクティブなタブの背景色を返します。 |
|
アクティブなタブのテキストの色を返します。 |
|
タブ コントロールのアクティブなページへのポインターを返します。 |
|
自動色指定に使用する色の配列への参照を返します。 |
|
最初に表示されるタブへのポインターを返します。 |
|
|
|
現在強調表示されているタブのインデックスを返します。 |
|
|
|
|
|
|
|
タブ コントロールに対するタブ領域の相対位置を示す LOCATION データ型の変数を返します。 たとえば、on the top や on the bottom です。 |
|
|
|
タブ付きウィンドウ内のタブ領域のサイズと位置を返します。 タブ領域の位置は、座標を使用して定義されます。 |
|
指定したタブの背景色を返します。 |
|
タブ コントロールのタブの境界線のサイズを返します。 |
|
指定した ID で識別されるタブのインデックスを返します。 |
|
|
|
指定した HWND オブジェクトを含むタブのインデックスを返します。 |
|
指定された位置を含むタブを返します。 |
|
|
|
指定されたタブに関連付けられているアイコンを返します。 |
|
タブのインデックスを使用してタブの ID を返します。 |
|
指定されたタブのアイコン ID を返します。 |
|
指定したタブのテキストを返します。 |
|
指定したタブのサイズと位置を取得します。 |
|
|
|
|
|
指定したタブのテキストの色を返します。 |
|
指定したタブ ページにあるペインへのポインターを返します。 |
|
指定したタブ ページにあるコントロールへの直接ポインターを返します (そのコントロールにラッパーがある場合でも)。 |
|
タブ コントロールに含まれるタブの数を返します。 |
|
CMFCBaseTabCtrl オブジェクトに関連付けられたツールヒント コントロールへの参照を返します。 |
|
表示されているタブの数を返します。 |
|
|
|
ウィンドウ タブを非表示にするオプションを設定します。ただし、タブ付きウィンドウに単一のタブのみが表示されている場合に限ります。 |
|
新しいタブを挿入します。 |
|
|
|
|
|
タブ付きウィンドウが自動カラー モードかどうかを示す値を返します。 |
|
|
|
|
|
|
|
|
|
タブ領域のフレームがフラットであるか 3D であるかを示す値を返します。 |
|
|
|
タブ コントロールがタブを非表示に設定されているかどうかを示す値を返します。ただし、タブ付きウィンドウに単一のタブが表示されている場合に限ります。 |
|
|
|
ユーザーがタブのラベルを修正できるかどうかを示します。 |
|
|
|
|
|
タブ付きウィンドウのタブが Microsoft OneNote のスタイルで表示されるかどうかを示します。 |
|
指定した点がタブ領域の内部にあるかどうかを確認します。 |
|
|
|
|
|
タブが切り離せるかどうかを示します。 |
|
タブがラベルではなくアイコンを表示しているかどうかを示します。 |
|
ユーザーがタブをドラッグしてタブの位置を変更できるかどうかを示します。 |
|
指定したタブが表示の状態にされているかどうかを示します。 |
|
|
|
|
|
タブの数が変更されたときに、フレームワークによって呼び出されます。 |
|
|
|
|
|
|
|
|
|
|
|
ウィンドウ メッセージが Windows 関数の TranslateMessage および DispatchMessage にディスパッチされる前に、メッセージを変換するために CWinApp クラスによって使用されます (CWnd::PreTranslateMessage をオーバーライドします)。 |
|
タブ付きウィンドウの内部レイアウトを再計算します。 |
|
タブ付きウィンドウからすべてのタブを削除します。 |
|
タブ付きウィンドウからタブを削除します。 |
|
|
|
タブ付きウィンドウに結び付けられたイメージ リストをリセットします。 |
|
オブジェクトをアーカイブから読み出したり、アーカイブに書き込んだりします。 (CObject::Serialize をオーバーライドします)。 |
|
タブをアクティブにします。 |
|
現在アクティブなタブの背景色を設定します。 |
|
アクティブなタブのテキストの色を設定します。 |
|
自動カラー モードが適用されているタブ コントロールの色を設定します。 |
|
CDockablePane クラス から派生しないオブジェクトに使用されるラッパー クラスを設定します。 |
|
タブ ラベルを描画するとき、先頭文字の処理を有効または無効にします。 |
|
アイコンのイメージ リストを設定します。 |
|
|
|
指定したタブの背景色を設定します。 |
|
新しいタブの境界線のサイズを設定します。 |
|
タブのアイコンを設定します。 |
|
タブのアイコン ID を設定します。 |
|
指定したタブに対して "アイコンのみ" モードを有効または無効にします。 |
|
タブ ラベルを指定された文字列値に設定します。 |
|
|
|
指定されたタブのテキストの色を設定します。 |
|
指定した順番にタブを並べ替えます。 |
|
指定されたタブの表示と非表示を切り替えます。 |
|
|
|
|
プロテクト メソッド
[名前] |
説明 |
|---|---|
CWnd から派生するが、CDockablePane からは派生しないオブジェクトのラッパーを作成します。 CMFCBaseTabCtrl オブジェクトをドッキングするために、埋め込まれた各コントロールは、ドッキング ラッパーを持つか、または CDockablePane から派生したものである必要があります。 SetDockingBayWrapperRTC を使用して、ラッパーのクラス行数を設定します。 |
データ メンバー
[名前] |
説明 |
|---|---|
タブがマウスの左ボタンか右ボタンのクリックによって選択されているかどうかを指定します。 |
|
タブに含まれているペインが自動的に破棄されるかどうかを指定します。 |
解説
CMFCBaseTabCtrl クラスは抽象クラスです。 したがって、インスタンス化することはできません。 タブ付きウィンドウを作成するには、CMFCBaseTabCtrl の派生クラスを作成する必要があります。 MFC ライブラリには、CMFCTabCtrl クラスおよび CMFCOutlookBarTabCtrl クラスの 2 つの派生クラスのサンプルが含まれています。
カスタマイズのヒント
次のヒントは、CMFCBaseTabCtrl クラスとそこから継承されるすべてのクラスに関するものです。
切り離し可能なタブを有効にした場合、ポインターをタブ付きウィンドウに置いたままにしないでください。 これらの切り離し可能なタブは、動的に作成したり破棄したりできます。 したがって、ポインターが無効になる場合があります。
ユーザーがマウスを使用してタブ コントロール上のタブを動的に移動できるように、タブ コントロールを設定できます。 この機能は、CMFCBaseTabCtrl クラスに組み込まれています。 有効にするには、CMFCBaseTabCtrl::EnableTabSwap を呼び出します。
タブをタブ コントロールに追加すると、既定では切り離し可能なタブが追加されます。 CMFCBaseTabCtrl::AddTab を使用して、切り離せないタブを追加することもできます。 bDetachable パラメーターを FALSE に設定すると、切り離しできないタブが追加されます。 CMFCBaseTabCtrl::EnableTabDetach メソッドを呼び出して、タブの切り離しを可能にするかどうかを変更することもできます。
CWnd クラスから派生したオブジェクトは、ドッキング可能コントロール バーまたはドッキング可能タブに配置できます。 ドッキングするコントロール全体に対して、CWnd オブジェクトをドッキング可能にする必要があります。 これを実現するには、MFC ラッパー クラスを使用します。 このラッパー クラスは CDockablePaneAdapter クラスです。 ドッキング可能コントロール バーまたはドッキング可能タブに追加された CWnd オブジェクトは、CDockablePaneAdapter オブジェクト内にラップされます。 CMFCBaseTablCtrl オブジェクトの m_bEnableWrapping パラメーターを FALSE に設定することにより、自動ラップを無効にできます。 CMFCBaseTabCtrl::SetDockingBarWrapperRTC メソッドを使用することで、アプリケーションがラッパーとして使用するクラスを変更することもできます。
継承階層
必要条件
**ヘッダー:**afxbasetabctrl.h