SFRTabPane

タブコントロールに使用するタブペインを表現するレスポンダです。

#include <SFRTabPane.hpp>

class SFRTabPane : public SFRPane;

typedef SFRTabPane&          SFRTabPaneRef;
typedef SFRTabPane*          SFRTabPanePtr;
typedef SFRTabPane**         SFRTabPaneHandle;
typedef const SFRTabPane     ConstSFRTabPane;
typedef const SFRTabPane&    ConstSFRTabPaneRef;
typedef const SFRTabPane*    ConstSFRTabPanePtr;
typedef const SFRTabPane**   ConstSFRTabPaneHandle;

継承図

協調図

解説

タブコントロールに使用するタブペインを表現するレスポンダです。タブペインは必ずタブコントロールと一緒に使用し、タブペインの親は必ずタブコントロールになります。タブペインは、各場所の色を設定することもできます。開発者はこのレスポンダを継承して、独自のタブペインを作成し、タブコントロールに登録することもできます。タブペインの一般的な使用方法は以下のようになります。

Void UserClass::Main(Void)
{
  SFRTabControlPtr  tab;
  SFRTabPanePtr     pane;

  tab = new SFRTabControl(window, SFURect(5, 5, 100, 100));
  // タブの色を設定します。特に設定しない場合はデフォルトの色が使用されます。
  tab->SetColor(SFRTabControl::COLOR_LIGHT, SFUColor(0x99, 0x99, 0x99));
  tab->SetColor(SFRTabControl::COLOR_BASE, SFUColor(0x66, 0x66, 0x66));
  tab->SetColor(SFRTabControl::COLOR_SHADOW, SFUColor(0x33, 0x33, 0x33));
  tab->SetColor(SFRTabControl::COLOR_TITLE, SFUColor(0xBB, 0xBB, 0xBB));
  // タブペインを作成します。
  pane = new SFRTabPane(tab, "page1");
  new SFRCheckboxControl(pane, SFURect(5, 5, 96, 16), "checkbox");
  // タブペインをもう一つ作成します。
  pane = new SFRTabPane(tab, "page2");
  return;
}

メンバ

コンストラクタ/デストラクタ
public	SFRTabPane	SFRTabPane クラスのコンストラクタです。
public	~SFRTabPane	SFRTabPane クラスのデストラクタです。

パブリック関数
public	FocusDown (SFRResponder から継承)	座標上で自分より下に存在するレスポンダにフォーカスを移動します。
public	FocusLeft (SFRResponder から継承)	座標上で自分より左に存在するレスポンダにフォーカスを移動します。
public	FocusNext (SFRResponder から継承)	フォーカスを一つ次に進めます。
public	FocusPrevious (SFRResponder から継承)	フォーカスを一つ前に戻します。
public	FocusRight (SFRResponder から継承)	座標上で自分より右に存在するレスポンダにフォーカスを移動します。
public	FocusUp (SFRResponder から継承)	座標上で自分より上に存在するレスポンダにフォーカスを移動します。
public	GetAttribute (SFRResponder から継承)	アトリビュートを取得します。
public	GetBack (SFRResponder から継承)	子階層のレスポンダのうち検索条件に一致するレスポンダを後ろから検索します。
public	GetBaseBound (SFRResponder から継承)	ベース領域を親レスポンダのコンテント座標系で取得します。
public	GetBaseWorld (SFRResponder から継承)	ベース領域を取得します。
public	GetColor (SFRPane から継承)	設定されている色を取得します。
public	GetContentBound (SFRResponder から継承)	コンテント領域をベース領域の座標系で取得します。
public	GetContentWorld (SFRResponder から継承)	コンテント領域を取得します。
public	GetDirector	親レスポンダを取得します。
public	GetFocus (SFRResponder から継承)	子階層のレスポンダのうちフォーカスされているレスポンダを取得します。
public	GetFront (SFRResponder から継承)	子階層のレスポンダのうち検索条件に一致するレスポンダを前から検索します。
public	GetIndexBackward (SFRResponder から継承)	同階層のレスポンダのうち自分が背面から数えて何番目かを返します。
public	GetIndexForward (SFRResponder から継承)	同階層のレスポンダのうち自分が前面から数えて何番目かを返します。
public	GetLeft (SFRResponder から継承)	グループ化されているレスポンダのうち自分より前にあるレスポンダで検索条件に一致するレスポンダを検索します。
public	GetMoveInterval (SFRResponder から継承)	MoveUpHandler, MoveDownHandler, MoveLeftHandler, MoveRightHandler によりレスポンダが移動されるときの移動量を取得します。
public	GetMoveMargin (SFRResponder から継承)	Move 関数によりレスポンダが移動されるときに、仮想領域の端から何ピクセル内側まで移動可能かのマージンを取得します。またこの設定は、MoveUpHandler, MoveDownHandler, MoveLeftHandler, MoveRightHandler にも適応されています。
public	GetNext (SFRResponder から継承)	自分より後にあるレスポンダで検索条件に一致するレスポンダを検索します。
public	GetNthBackward (SFRResponder から継承)	子階層のレスポンダのうち検索条件に一致するレスポンダで後ろから数えてＮ番目にあるレスポンダを検索します。
public	GetNthForward (SFRResponder から継承)	子階層のレスポンダのうち検索条件に一致するレスポンダで前から数えてＮ番目にあるレスポンダを検索します。
public	GetPrevious (SFRResponder から継承)	自分より前にあるレスポンダで検索条件に一致するレスポンダを検索します。
public	GetReference (SFRResponder から継承)	ユーザが自由に設定できるリファレンス値を取得します。
public	GetRight (SFRResponder から継承)	グループ化されているレスポンダのうち自分より後にあるレスポンダで検索条件に一致するレスポンダを検索します。
public	GetScrollInterval (SFRResponder から継承)	ScrollUpHandler, ScrollDownHandler, ScrollLeftHandler, ScrollRightHandler によりレスポンダの仮想領域がスクロールされるときのスクロール量を取得します。
public	GetStatusEnable (SFRResponder から継承)	応答可能/不可能フラグを取得します。
public	GetStatusFocus (SFRResponder から継承)	フォーカス/非フォーカスフラグを取得します。
public	GetStatusTarget (SFRResponder から継承)	ターゲット/非ターゲットフラグを取得します。
public	GetStatusVisible (SFRResponder から継承)	可視/不可視フラグを取得します。
public	GetTitle	設定されているタイトルを取得します。
public	GetTranslate (SFRResponder から継承)	コンテント座標系での仮想領域の原点座標を取得します。
public	GetTravelMargin (SFRResponder から継承)	フォーカスされたレスポンダを自動的にコンテント領域内に移動させるときに、コンテント領域の端から何ピクセル内側に移動させるかのマージンを取得します。
public	GetType (SFRResponder から継承)	タイプを取得します。
public	GetVirtualBound (SFRResponder から継承)	仮想領域をコンテント領域の座標系で取得します。
public	GetVirtualWorld (SFRResponder から継承)	仮想領域を取得します。
public	Group	レスポンダをグループ化します。【無効】
public	GroupMove (SFRResponder から継承)	グループ化されているレスポンダすべてを移動します。
public	GroupScroll (SFRResponder から継承)	グループ化されているレスポンダすべての仮想領域をスクロールします。
public	GroupSelect (SFRResponder から継承)	グループ化されているレスポンダすべてを最前面に移動させます。
public	GroupStatusEnable (SFRResponder から継承)	グループ化されているレスポンダすべてに対して、応答可能/不可能フラグを設定します。
public	GroupStatusVisible (SFRResponder から継承)	グループ化されているレスポンダすべてに対して、可視/不可視フラグを設定します。
public	InvalidateBase (SFRResponder から継承)	ベース領域内のアップデート領域を登録します。
public	InvalidateContent (SFRResponder から継承)	コンテント領域内のアップデート領域を登録します。
public	InvalidateVirtual (SFRResponder から継承)	仮想領域内のアップデート領域を登録します。
public	Invoke (SFRResponder から継承)	イベントを送信します。
public	Move (SFRResponder から継承)	レスポンダを移動します。
public	RegisterHandler (SFRHandler から継承)	ハンドラを登録します。
public	RegisterIntelligentHandler (SFRResponder から継承)	SelectHandler, ClearHandler, FocusUpHandler, FocusDownHandler, FocusLeftHandler, FocusRightHandler をそれぞれ AVK_SELECT, AVK_CLR, AVK_UP, AVK_DOWN, AVK_LEFT, AVK_RIGHT に登録します。
public	RegisterManipulateHandler (SFRResponder から継承)	SelectHandler, ClearHandler, FocusNextHandler, FocusPreviousHandler をそれぞれ AVK_SELECT, AVK_CLR, AVK_DOWN, AVK_UP に登録します。
public	RegisterMoveHandler (SFRResponder から継承)	MoveUpHandler, MoveDownHandler, MoveLeftHandler, MoveRightHandler をそれぞれ AVK_2, AVK_8, AVK_4, AVK_6 に登録します。
public	RegisterScrollHandler (SFRResponder から継承)	ScrollUpHandler, ScrollDownHandler, ScrollLeftHandler, ScrollRightHandler をそれぞれ AVK_2, AVK_8, AVK_4, AVK_6 に登録します。
public	RegisterTracer (SFRTracer から継承)	トレーサを登録します。
public	Scroll (SFRResponder から継承)	仮想領域をスクロールします。
public	Select	ペインを選択します。
public	SetBaseBound	ベース領域の座標を設定します。【無効】
public	SetColor (SFRPane から継承)	色を設定します。
public	SetContentBound	コンテント領域の座標を設定します。【無効】
public	SetMoveInterval (SFRResponder から継承)	MoveUpHandler, MoveDownHandler, MoveLeftHandler, MoveRightHandler によりレスポンダが移動されるときの移動量を設定します。
public	SetMoveMargin (SFRResponder から継承)	Move 関数によりレスポンダが移動されるときに、仮想領域の端から何ピクセル内側まで移動可能かのマージンを設定します。またこの設定は、MoveUpHandler, MoveDownHandler, MoveLeftHandler, MoveRightHandler にも適応されます。
public	SetReference (SFRResponder から継承)	ユーザが自由に設定できるリファレンス値を設定します。
public	SetScrollInterval (SFRResponder から継承)	ScrollUpHandler, ScrollDownHandler, ScrollLeftHandler, ScrollRightHandler によりレスポンダの仮想領域がスクロールされるときのスクロール量を設定します。
public	SetStatusEnable	応答可能 / 不可能フラグを設定します。
public	SetStatusFocus	フォーカス / 非フォーカスフラグを設定します。
public	SetStatusTarget (SFRResponder から継承)	ターゲット/非ターゲットフラグを設定します。
public	SetStatusVisible	可視 / 不可視フラグを設定します。
public	SetTitle	タイトルを設定します。
public	SetTranslate (SFRResponder から継承)	コンテント座標系での仮想領域の原点座標を設定します。
public	SetTravelMargin (SFRResponder から継承)	フォーカスされたレスポンダを自動的にコンテント領域内に移動させるときに、コンテント領域の端から何ピクセル内側に移動させるかのマージンを設定します。
public	SetVirtualBound (SFRResponder から継承)	仮想領域をコンテント領域の座標系で設定します。
public	Travel (SFRResponder から継承)	設定された長方形が可視領域に入るように、レスポンダの仮想領域をスクロールします。
public	Ungroup	レスポンダのグループ化を解除します。【無効】
public	UnregisterHandler (SFRHandler から継承)	登録されているハンドラを削除します。
public	UnregisterTracer (SFRTracer から継承)	登録されているトレーサを削除します。

プロテクト関数
protected	ClearHandler (SFRResponder から継承)	クリアキーが押されたときのハンドラです。
protected	FocusDownHandler (SFRResponder から継承)	下矢印キーが押されたときのハンドラです。座標上で自分より下に存在するレスポンダにフォーカスを移動します。
protected	FocusLeftHandler (SFRResponder から継承)	左矢印キーが押されたときのハンドラです。座標上で自分より左に存在するレスポンダにフォーカスを移動します。
protected	FocusNextHandler (SFRResponder から継承)	下矢印キーが押されたときのハンドラです。フォーカスを一つ後に移動します。
protected	FocusPreviousHandler (SFRResponder から継承)	上矢印キーが押されたときのハンドラです。フォーカスを一つ前に移動します。
protected	FocusRightHandler (SFRResponder から継承)	右矢印キーが押されたときのハンドラです。座標上で自分より右に存在するレスポンダにフォーカスを移動します。
protected	FocusUpHandler (SFRResponder から継承)	上矢印キーが押されたときのハンドラです。座標上で自分より上に存在するレスポンダにフォーカスを移動します。
protected	GetAppearanceTransparent (SFRResponder から継承)	APPEARANCE_TRANSPARENT フラグが設定されているかどうかを取得します。
protected	GetInheriteEnable (SFRResponder から継承)	現在の応答可能/不可能の状態を取得します。
protected	GetInheriteFocus (SFRResponder から継承)	現在のフォーカス/非フォーカスの状態を取得します。
protected	GetInheriteTarget (SFRResponder から継承)	現在のターゲット/非ターゲットの状態を取得します。
protected	GetInheriteVisible (SFRResponder から継承)	現在の可視/不可視の状態を取得します。
protected	GetPropertyClosable (SFRResponder から継承)	PROPERTY_CLOSABLE フラグが設定されているかどうかを取得します。
protected	GetPropertyDirect (SFRResponder から継承)	PROPERTY_DIRECT フラグが設定されているかどうかを取得します。
protected	GetPropertyMovable (SFRResponder から継承)	PROPERTY_MOVABLE フラグが設定されているかどうかを取得します。
protected	GetPropertyScrollable (SFRResponder から継承)	PROPERTY_SCROLLABLE フラグが設定されているかどうかを取得します。
protected	GetPropertySelect (SFRResponder から継承)	PROPERTY_SELECT フラグが設定されているかどうかを取得します。
protected	GetPropertyTravel (SFRResponder から継承)	PROPERTY_TRAVEL フラグが設定されているかどうかを取得します。
protected	MoveDownHandler (SFRResponder から継承)	数字の８キーが押されたときのハンドラです。
protected	MoveLeftHandler (SFRResponder から継承)	数字の４キーが押されたときのハンドラです。
protected	MoveRightHandler (SFRResponder から継承)	数字の６キーが押されたときのハンドラです。
protected	MoveUpHandler (SFRResponder から継承)	数字の２キーが押されたときのハンドラです。
protected	ScrollDownHandler (SFRResponder から継承)	数字の８キーが押されたときのハンドラです。
protected	ScrollLeftHandler (SFRResponder から継承)	数字の４キーが押されたときのハンドラです。
protected	ScrollRightHandler (SFRResponder から継承)	数字の６キーが押されたときのハンドラです。
protected	ScrollUpHandler (SFRResponder から継承)	数字の２キーが押されたときのハンドラです。
protected	SelectHandler (SFRResponder から継承)	セレクトキーが押されたときのハンドラです。
protected	UnregisterIntelligentHandler (SFRResponder から継承)	AVK_SELECT, AVK_CLR, AVK_UP, AVK_DOWN, AVK_LEFT, AVK_RIGHT に登録されているハンドラを削除します。
protected	UnregisterManipulateHandler (SFRResponder から継承)	AVK_SELECT, AVK_CLR, AVK_DOWN, AVK_UP に登録されているハンドラを削除します。
protected	UnregisterMoveHandler (SFRResponder から継承)	AVK_2, AVK_8, AVK_4, AVK_6 に登録されているハンドラを削除します。
protected	UnregisterScrollHandler (SFRResponder から継承)	AVK_2, AVK_8, AVK_4, AVK_6 に登録されているハンドラを削除します。

型
	BehaviorEnum (SFRResponder から継承)	レスポンダのビヘイビアを表します。
	ColorEnum (SFRPane から継承)	色の設定 / 取得時に使用するパレットインデックスです。
	HandlerEnum (SFRHandler から継承)	ハンドラの呼び出されるタイミングを表します。
	TracerEnum (SFRTracer から継承)	トレース順序を表します。

SFRTabPane::SFRTabPane

SFRTabPane クラスのコンストラクタです。

[ public ]
SFRTabPane(
    SFRTabControlPtr director                  // 親レスポンダ
    ConstSFUWideStringRef title                // タイトル文字列
    BehaviorType behavior = BEHAVIOR_TABPANE   // ビヘイビア
    SFCType attribute = ATTRIBUTE_TABPANE      // アトリビュート
);

解説

タブコントロールが使用するタブペインのコンストラクタです。

参照

SFRTabPane::~SFRTabPane

SFRTabPane::~SFRTabPane

SFRTabPane クラスのデストラクタです。

[ public, virtual ]
~SFRTabPane(Void);

参照

SFRTabPane::SFRTabPane

SFRTabPane::GetDirector

親レスポンダを取得します。

[ public, const ]
SFRTabControlPtr GetDirector(Void);

解説

親レスポンダを取得します。親レスポンダは必ずタブコントロールとなります。

参照

SFRResponder::GetDirector

SFRTabPane::GetTitle

設定されているタイトルを取得します。

[ public, const ]
ConstSFUWideStringRef GetTitle(Void);

解説

タブペインに設定されているタイトルを取得します。

参照

SFRTabPane::SetTitle

SFRTabPane::Group

レスポンダをグループ化します。【無効】

[ public, virtual ]
Void Group(
    SFRResponderPtr param   // レスポンダ
);

解説

レスポンダをグループ化します。 SFRTabPane を継承したクラスでは、この関数を使用しても設定は無視されます。

参照

SFRResponder::Group | SFRResponder::Ungroup

SFRTabPane::Select

ペインを選択します。

[ public, virtual ]
Void Select(Void);

解説

タブペインを選択します。タブコントロールに関連付けられたタブペインを選択するということは、特定のタブを表示することと同じです。

使用例

２ページ目のタブを表示します。

SFRTabControlPtr  tab;
SFRTabPanePtr     pane;

tab = new SFRTabControl(window, SFURect(5, 5, 100, 100));
new SFRTabPane(tab, "page1");
pane = SFRTabPane(tab, "page2");
new SFRTabPane(tab, "page3");
pane->Select();

参照

SFRResponder::Select

SFRTabPane::SetBaseBound

ベース領域の座標を設定します。【無効】

[ public, virtual ]
Void SetBaseBound(
    ConstSFURectRef param   // ベース領域
);

解説

ベース領域を親の仮想領域の座標で設定します。 SFRTabPane を継承したクラスでは、この関数を使用しても設定は無視されます。

参照

SFRResponder::GetBaseBound | SFRResponder::SetBaseBound

SFRTabPane::SetContentBound

コンテント領域の座標を設定します。【無効】

[ public, virtual ]
Void SetContentBound(
    ConstSFURectRef param   // コンテント領域
);

解説

コンテント領域をベース領域の座標で設定します。 SFRTabPane を継承したクラスでは、この関数を使用しても設定は無視されます。

参照

SFRResponder::GetContentBound | SFRResponder::SetContentBound

SFRTabPane::SetStatusEnable

応答可能 / 不可能フラグを設定します。

[ public, virtual ]
Void SetStatusEnable(
    Bool param   // 状態
);

解説

タブペインの応答可能 / 不可能フラグを設定します。タブコントロールに関連づけられたタブペインの応答可能 / 不可能フラグを設定するということは、特定のタブを操作可能にしたり、操作不可能にしたりすることと同じです。

使用例

２ページ目のタブを操作不可能にします。

SFRTabControlPtr  tab;
SFRTabPanePtr     pane;

tab = new SFRTabControl(window, SFURect(5, 5, 100, 100));
new SFRTabPane(tab, "page1");
pane = SFRTabPane(tab, "page2");
new SFRTabPane(tab, "page3");
pane->SetStatusEnable(FALSE);

参照

SFRResponder::GetStatusEnable | SFRResponder::SetStatusEnable | SFRResponder::GetInheriteEnable

SFRTabPane::SetStatusFocus

フォーカス / 非フォーカスフラグを設定します。

[ public, virtual ]
Void SetStatusFocus(
    Bool param   // 状態
);

解説

タブペインのフォーカス / 非フォーカスフラグを設定します。タブコントロールに関連づけられたタブペインのフォーカス / 非フォーカスフラグを設定するということは、特定のタブをフォーカスしたり、非フォーカスにしたりすることと同じです。フォーカスされているタブは常に最前面のために、自動的に Select されます。

使用例

２ページ目のタブをフォーカスします。

SFRTabControlPtr  tab;
SFRTabPanePtr     pane;

tab = new SFRTabControl(window, SFURect(5, 5, 100, 100));
new SFRTabPane(tab, "page1");
pane = SFRTabPane(tab, "page2");
new SFRTabPane(tab, "page3");
pane->SetStatusFocus(TRUE);

参照

SFRResponder::GetStatusFocus | SFRResponder::SetStatusFocus | SFRResponder::GetInheriteFocus

SFRTabPane::SetStatusVisible

可視 / 不可視フラグを設定します。

[ public, virtual ]
Void SetStatusVisible(
    Bool param   // 状態
);

解説

タブペインの可視 / 不可視フラグを設定します。タブコントロールに関連づけられたタブペインの可視 / 不可視フラグを設定するということは、特定のタブを表示したり、非表示にしたりすることと同じです。

使用例

２ページ目のタブを非表示にします。

SFRTabControlPtr  tab;
SFRTabPanePtr     pane;

tab = new SFRTabControl(window, SFURect(5, 5, 100, 100));
new SFRTabPane(tab, "page1");
pane = SFRTabPane(tab, "page2");
new SFRTabPane(tab, "page3");
pane->SetStatusVisible(FALSE);

参照

SFRResponder::GetStatusVisible | SFRResponder::SetStatusVisible | SFRResponder::GetInheriteVisible

SFRTabPane::SetTitle

タイトルを設定します。

[ public ]
Void SetTitle(
    ConstSFUWideStringRef param   // タイトル
);

解説

タブペインのタイトル文字列を設定します。

使用例

タイトルを "sample" でタブペインを生成し、その後、タイトルを "changed" に変更します。

SFRTabControlPtr  tab;
SFRTabPanePtr     pane;

tab = new SFRTabControl(window, SFURect(5, 5, 100, 100));
pane = new SFRTabPane(tab, "sample");
pane->SetTitle("changed");

参照

SFRTabPane::GetTitle

SFRTabPane::Ungroup

レスポンダのグループ化を解除します。【無効】

[ public, virtual ]
Void Ungroup(Void);

解説

レスポンダのグループ化を解除します。 SFRTabPane を継承したクラスでは、この関数を使用しても設定は無視されます。

参照

SFRResponder::Group | SFRResponder::Ungroup