前のページ次のページ上に戻るホーム BREW C++ ライブラリ & GUI フレームワーク : SophiaFramework 3.0
SFBMenuCtl
IMenuCtl インターフェイスのラッパークラスです。
#include <SFBMenuCtl.h.hpp>
class SFBMenuCtl : public SFBControl;
SFMTYPEDEFWRAPPER(SFBMenuCtl)

継承図

SFBMenuCtl クラスの継承図

協調図

SFBMenuCtl クラスの協調図

参照

BREW API IMenuCtl

バグ情報

メニュー プロパティ
ドキュメント エラー BREW API リファレンス 2.0.1.5

メニュー プロパティについては、複数箇所に記述があり、その記述内容に若干の異同があります。 「データ構造 (Data Structure)」の AEE メニュー プロパティ (AEE Menu Properties) のページに 記載されているのが正しい情報です。

IMENUCTL_AddItem, IMENUCTL_AddItemEx
Tips すべて

リソースファイルから項目テキストを読み込ませる場合、 セットできる文字は null 終端を含め 128 文字までです。 これ以上の文字をセットしようとすると、 EFAILED が返り、項目は追加されません。

IMENUCTL_SetStyle
Tips すべて

リストコントロール (AEECLSID_LISTCTL) に対しては、 Style を変更することが出来ません。

IMENUCTL_SetColor (1/2)
Tips 日本の端末

ソフトキーコントロール (AEECLSID_SOFTKEYCTL) に対しては、 色の変更を行うことは出来ません。

IMENUCTL_SetColor (2/2)
Tips すべて

リストビューコントロール以外では、 タイトルの文字色と背景色を変更することは出来ません。

メンバ

パブリック関数
Bool AddItem( ACharConstPtr resFile , UInt16 resID , UInt16 itemID , UInt32 data )
AddItem( UInt16 itemID , SFXWideStringPtr text , UInt32 data )
AddItem( SFXAnsiStringConstRef resFile , UInt16 resID , UInt16 itemID , UInt32 data )
AddItem( UInt16 itemID , WCharPtr text , UInt32 data )
メニューに新しいメニュー項目を追加します。
Bool AddItemEx( CtlAddItem* item )
項目をメニュー、リスト、またはアイコン表示に追加します。
Bool DeleteAll( Void )
メニューコントロールオブジェクトからすべてのメニュー項目を削除します。
Bool DeleteItem( UInt16 itemID )
メニュー コントロールからメニュー項目を削除します。
Void EnableCommand( Bool enable )
デバイスユーザーが選択キーを押したことにより生成されたイベントを受け取ったときに、指定されたコマンドをAEEシェルに送信するためにメニューコントロールオブジェクトを使用可能にします。
UInt16 EnumNextSel( Void )
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
Bool EnumSelInit( Void )
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
UInt16 GetFocus( Void )
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
Bool GetItem( UInt16 itemID , CtlAddItem* item )
メニュー項目に関連付けられた値を問い合わせます。
SInt32 GetItemCount( Void )
メニュー内の項目の数を返します。
Bool GetItemData( UInt16 itemID , UInt32Ptr data )
指定されたメニューコントロールオブジェクトのメニュー項目に関連するデータを取得します。
UInt16 GetItemID( SInt32 index )
インデックスが指定された項目の項目IDを返します。
SInt32 GetItemTime( UInt16 itemID , UInt16Ptr duration )
メニューコントロールがカレンダーの場合、メニュー項目IDで指定されたメニュー項目の開始時刻と継続時間(開始時刻と終了時刻の間隔)を取得します。
UInt16 GetSel( Void )
メニューコントロールオブジェクトで現在選択されているメニュー項目識別子を取得します。
Void MoveItem( UInt16 itemID , SInt32 direction )
指定された方向にメニュー項目の位置を1つ移動します。
static
SFBMenuCtlSmp
NewInstance( AEECLSID clsid )
SFBMenuCtl インターフェイスのインスタンスを取得します。
Void SetColors( AEEMenuColors* colors )
デフォルトでは、メニュー要素の色を決定するのは、デバイスのメーカーによって定義されているシステムカラーテーブルのエントリです。
Void SetFocus( UInt16 itemID )
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
Bool SetItem( UInt16 itemID , UInt16 flags , CtlAddItem* item )
メニュー項目が作成された後で項目の任意のフィールドを設定します。
Void SetItemText( UInt16 itemID , ACharConstPtr resFile , UInt16 resID )
SetItemText( UInt16 itemID , SFXWideStringPtr text )
SetItemText( UInt16 itemID , SFXAnsiStringConstRef resFile , UInt16 resID )
SetItemText( UInt16 itemID , WCharPtr text )
メニュー項目IDで指定された新しいメニュー項目にテキスト名を設定します。
Void SetItemTime( UInt16 itemID , UInt16 minStart , UInt16 duration )
カレンダーメニューコントロールを設定します。
Void SetSel( UInt16 itemID )
MP_NO_REDRAWプロパティが設定されていない場合、指定されたメニュー項目をメニューコントロールオブジェクトの現在の選択値に設定し、再描画を要求します。
Void SetSelEx( UInt16 itemID , Bool selected )
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
Void SetStyle( AEEItemStyle* normal , AEEItemStyle* selected )
メニュー項目の表示スタイルを設定します。
Bool SetTitle( ACharConstPtr resFile , UInt16 resID )
SetTitle( SFXWideStringPtr text )
SetTitle( SFXAnsiStringConstRef resFile , UInt16 resID )
SetTitle( WCharPtr text )
メニューコントロールオブジェクトのタイトルを設定します。
Void Sort( AEEMenuSortType type )
メニュー内の項目を並べ替えます。
Void SortCustom( PFNMENUSORTCOMPARE notify , VoidPtr data )
ユーザー供給の比較コールバックを使ってメニューをソートします。
UInt32 GetProperties( Void ) (SFBControl から継承)
コントロール固有のプロパティまたはフラグを返します。
Void GetRect( SFXRectanglePtr rect ) (SFBControl から継承)
コントロールの矩形を取得します。
SFXRectangle GetRect( Void ) (SFBControl から継承)
コントロールの矩形を取得します。
Bool HandleEvent( AEEEvent event , UInt16 wParam , UInt32 dwParam ) (SFBControl から継承)
HandleEvent( SFXEventConstRef event ) (SFBControl から継承)
コントロールのイベント処理機能を提供します。 この関数はすべてのコントロールで実装する必要があります。
Bool IsActive( Void ) (SFBControl から継承)
コントロールのアクティブ状態を返します。
Bool Redraw( Void ) (SFBControl から継承)
コントロールの内容を再描画します。
Void Reset( Void ) (SFBControl から継承)
コントロールの内容をリセットし、アクティブ状態をすぐに解除します。
Void SetActive( Bool active = true ) (SFBControl から継承)
コントロールのアクティブ状態を設定/解除します。
Void SetProperties( UInt32 properties ) (SFBControl から継承)
コントロール固有のプロパティまたはフラグを設定します。
Void SetRect( SFXRectangleConstRef rect ) (SFBControl から継承)
コントロールの矩形を設定します。

SFBMenuCtl::AddItem
メニューに新しいメニュー項目を追加します。
[ public ]
Bool AddItem(
    ACharConstPtr resFile   // リソースファイル名を含むnull 終結文字列。
    UInt16 resID            // テキスト文字列のリソースを識別するリソース識別子。
    UInt16 itemID           // メニュー項目を一意に識別する項目識別子。
    UInt32 data             // メニュー項目に関連付ける項目データ。
);
[ public ]
Bool AddItem(
    UInt16 itemID   // リソースファイル名を含むnull 終結文字列。
    WCharPtr text   // テキスト文字列のリソースを識別するリソース識別子。
    UInt32 data     // メニュー項目に関連付ける項目データ。
);
[ public ]
Bool AddItem(
    SFXAnsiStringConstRef resFile   // リソースファイル名。
    UInt16 resID                    // テキスト文字列のリソースを識別するリソース識別子。
    UInt16 itemID                   // メニュー項目を一意に識別する項目識別子。
    UInt32 data                     // メニュー項目に関連付ける項目データ。
);
[ public ]
Bool AddItem(
    UInt16 itemID           // メニュー項目を一意に識別する項目識別子。
    SFXWideStringPtr text   // メニュー項目名を含むnull 終結文字列。
    UInt32 data             // メニュー項目に関連付ける項目データ。
);

参照

BREW API IMENUCTL_AddItem | SFBMenuCtl::DeleteItem | SFBControl::Redraw | SFBControl::SetActive


SFBMenuCtl::AddItemEx
項目をメニュー、リスト、またはアイコン表示に追加します。
[ public ]
Bool AddItemEx(
    CtlAddItem* item   // CtlAddItem 構造体へのポインタ。
);

参照

BREW API IMENUCTL_AddItemEx | SFBControl::Redraw | SFBMenuCtl::AddItem


SFBMenuCtl::DeleteAll
メニューコントロールオブジェクトからすべてのメニュー項目を削除します。
[ public ]
Bool DeleteAll(Void);

参照

BREW API IMENUCTL_DeleteAll


SFBMenuCtl::DeleteItem
メニュー コントロールからメニュー項目を削除します。
[ public ]
Bool DeleteItem(
    UInt16 itemID   // メニュー項目をメニューに追加したときに使用したメニュー項目識別子。
);

参照

BREW API IMENUCTL_DeleteItem


SFBMenuCtl::EnableCommand
デバイスユーザーが選択キーを押したことにより生成されたイベントを受け取ったときに、指定されたコマンドをAEEシェルに送信するためにメニューコントロールオブジェクトを使用可能にします。
[ public ]
Void EnableCommand(
    Bool enable   // 送信可能/送信不可を示すブールフラグ。
);

参照

BREW API IMENUCTL_EnableCommand | SFBControl::HandleEvent


SFBMenuCtl::EnumNextSel
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
[ public ]
UInt16 EnumNextSel(Void);

参照

BREW API IMENUCTL_EnumNextSel | SFBMenuCtl::EnumSelInit


SFBMenuCtl::EnumSelInit
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
[ public ]
Bool EnumSelInit(Void);

参照

BREW API IMENUCTL_EnumSelInit | SFBMenuCtl::EnumNextSel


SFBMenuCtl::GetFocus
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
[ public ]
UInt16 GetFocus(Void);

参照

BREW API IMENUCTL_GetFocus | SFBMenuCtl::SetFocus


SFBMenuCtl::GetItem
メニュー項目に関連付けられた値を問い合わせます。
[ public ]
Bool GetItem(
    UInt16 itemID      // メニュー項目ID。
    CtlAddItem* item   // 項目情報の構造体。
);

参照

BREW API IMENUCTL_GetItem | CtlAddItem | SFBMenuCtl::SetItem


SFBMenuCtl::GetItemCount
メニュー内の項目の数を返します。
[ public ]
SInt32 GetItemCount(Void);

参照

BREW API IMENUCTL_GetItemCount | SFBMenuCtl::GetItemID


SFBMenuCtl::GetItemData
指定されたメニューコントロールオブジェクトのメニュー項目に関連するデータを取得します。
[ public ]
Bool GetItemData(
    UInt16 itemID    // このメニュー項目をメニューに追加したときに使用したメニュー項目識別子。
    UInt32Ptr data   // 項目データを格納するプレースホルダー。
);

参照

BREW API IMENUCTL_GetItemData | SFBMenuCtl::AddItem


SFBMenuCtl::GetItemID
インデックスが指定された項目の項目IDを返します。
[ public ]
UInt16 GetItemID(
    SInt32 index   // 項目のインデックス。
);

参照

BREW API IMENUCTL_GetItemID


SFBMenuCtl::GetItemTime
メニューコントロールがカレンダーの場合、メニュー項目IDで指定されたメニュー項目の開始時刻と継続時間(開始時刻と終了時刻の間隔)を取得します。
[ public ]
SInt32 GetItemTime(
    UInt16 itemID        // メニュー項目識別子。
    UInt16Ptr duration   // 継続時間(分)。
);

参照

BREW API IMENUCTL_GetItemTime | SFBMenuCtl::SetItemTime


SFBMenuCtl::GetSel
メニューコントロールオブジェクトで現在選択されているメニュー項目識別子を取得します。
[ public ]
UInt16 GetSel(Void);

参照

BREW API IMENUCTL_GetSel | SFBMenuCtl::SetSel


SFBMenuCtl::MoveItem
指定された方向にメニュー項目の位置を1つ移動します。
[ public ]
Void MoveItem(
    UInt16 itemID      // メニュー項目識別子。
    SInt32 direction   // 方向:  -1: 上へ / 1: 下へ
);

参照

BREW API IMENUCTL_MoveItem


SFBMenuCtl::NewInstance
SFBMenuCtl インターフェイスのインスタンスを取得します。
[ public, static ]
SFBMenuCtlSmp NewInstance(
    AEECLSID clsid   
);

SFBMenuCtl::SetColors
デフォルトでは、メニュー要素の色を決定するのは、デバイスのメーカーによって定義されているシステムカラーテーブルのエントリです。
[ public ]
Void SetColors(
    AEEMenuColors* colors   // 色を変更する項目を示すビットマスクと、色の値の両方が含まれる構造体へのポインタ。
);

参照

BREW API IMENUCTL_SetColors | AEEMenuColors


SFBMenuCtl::SetFocus
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
[ public ]
Void SetFocus(
    UInt16 itemID   // 設定する項目のID。
);

参照

BREW API IMENUCTL_SetFocus | SFBMenuCtl::GetFocus


SFBMenuCtl::SetItem
メニュー項目が作成された後で項目の任意のフィールドを設定します。
[ public ]
Bool SetItem(
    UInt16 itemID      // メニュー項目ID。
    UInt16 flags       // CtlAddItem 構造体の有効フィールドのマスク。
    CtlAddItem* item   // 項目情報の構造体。
);

参照

BREW API IMENUCTL_SetItem | CtlAddItem | SFBMenuCtl::GetItem | SFBControl::Redraw


SFBMenuCtl::SetItemText
メニュー項目IDで指定された新しいメニュー項目にテキスト名を設定します。
[ public ]
Void SetItemText(
    UInt16 itemID           // メニュー項目識別子。
    ACharConstPtr resFile   // リソースファイル名を含む null 終結文字列。
    UInt16 resID            // リソースID。
);
[ public ]
Void SetItemText(
    UInt16 itemID   // メニュー項目識別子。
    WCharPtr text   // 文字列形式の新しいメニュー項目テキスト。
);
[ public ]
Void SetItemText(
    UInt16 itemID                   // メニュー項目識別子。
    SFXAnsiStringConstRef resFile   // リソースファイル名。
    UInt16 resID                    // リソースID。
);
[ public ]
Void SetItemText(
    UInt16 itemID           // メニュー項目識別子。
    SFXWideStringPtr text   // 新しいメニュー項目テキスト。
);

参照

BREW API IMENUCTL_SetItemText


SFBMenuCtl::SetItemTime
カレンダーメニューコントロールを設定します。
[ public ]
Void SetItemTime(
    UInt16 itemID     // メニュー項目識別子。
    UInt16 minStart   // 開始時刻(分)。
    UInt16 duration   // 継続時間(分)。
);

参照

BREW API IMENUCTL_SetItemTime | SFBMenuCtl::GetItemTime


SFBMenuCtl::SetSel
MP_NO_REDRAWプロパティが設定されていない場合、指定されたメニュー項目をメニューコントロールオブジェクトの現在の選択値に設定し、再描画を要求します。
[ public ]
Void SetSel(
    UInt16 itemID   // メニュー項目識別子。メニュー項目をメニューに追加したときに使用した識別子を指定する。
);

参照

BREW API IMENUCTL_SetSel | SFBMenuCtl::GetSel


SFBMenuCtl::SetSelEx
この関数は、マルチ選択メニュー(MP_MULTI_SEL)でのみ使用します。
[ public ]
Void SetSelEx(
    UInt16 itemID   // 設定する項目のID。
    Bool selected   // 項目を選択/選択解除する。
);

参照

BREW API IMENUCTL_SetSelEx


SFBMenuCtl::SetStyle
メニュー項目の表示スタイルを設定します。
[ public ]
Void SetStyle(
    AEEItemStyle* normal     // 通常のメニュー項目のスタイル。
    AEEItemStyle* selected   // 選択されたメニュー項目のスタイル。
);

参照

BREW API IMENUCTL_SetStyle | AEEItemStyle


SFBMenuCtl::SetTitle
メニューコントロールオブジェクトのタイトルを設定します。
[ public ]
Bool SetTitle(
    ACharConstPtr resFile   // リソースファイル名を含む null 終結文字列。
    UInt16 resID            // リソース識別子。
);
[ public ]
Bool SetTitle(
    WCharPtr text   // メニュータイトルに使用する null 終結文字列。
);
[ public ]
Bool SetTitle(
    SFXAnsiStringConstRef resFile   // リソースファイル名。
    UInt16 resID                    // リソース識別子。
);
[ public ]
Bool SetTitle(
    SFXWideStringPtr text   // メニュータイトルに使用する文字列。
);

参照

BREW API IMENUCTL_SetTitle SFBControl::Redraw


SFBMenuCtl::Sort
メニュー内の項目を並べ替えます。
[ public ]
Void Sort(
    AEEMenuSortType type   // ソートタイプ。
);

参照

BREW API IMENUCTL_Sort | AEEMenuSortType | SFBMenuCtl::SortCustom


SFBMenuCtl::SortCustom
ユーザー供給の比較コールバックを使ってメニューをソートします。
[ public ]
Void SortCustom(
    PFNMENUSORTCOMPARE notify   // ユーザーのソート比較コールバック。
    VoidPtr data                // 比較関数に渡されるユーザーコンテキストデータへのポインタ。
);

参照

BREW API IMENUCTL_SortCustom | PFNMENUSORTCOMPARE | SFBMenuCtl::Sort