最近のアクセス:
ページ
履歴
バックリンク
Menu オブジェクト
アクションを行うためにユーザーが選択できるアイテムのセットを表示します。
説明
メニューは、通常、ネイティブモバイル アプリケーションのエントリーポイントです。メニューには、ユーザーが選択できるアイテムのセットが表示されます。たとえば、
Work With オブジェクト
、
Panel オブジェクト
、メニュー、Web ページへのリンク、電話の発信やメールの送信などのアクションへのリンクなどのアイテムが表示されます。
Menu オブジェクトは
[ 新規オブジェクト ] ダイアログ
から作成できます。
オブジェクトのプロパティ
Menu オブジェクトの主なプロパティは次のとおりです。
[ Name ] プロパティ
オブジェクトの名前です。
[ Description ] プロパティ
オブジェクトの説明です。
[ Module/Folder ] プロパティ
オブジェクトが属する
フォルダ
または
モジュール
です。
[ Object Visibility ] プロパティ
ほかの Module オブジェクトがアクセスできるかどうかを指定します。
[ Main program ] プロパティ
既定で有効になります。
ネイティブモバイルのメインオブジェクトのプロパティ
を参照してください。
[ Connectivity Support ] プロパティ
オブジェクトがオンラインかオフラインかを定義します。
[ Enable Data Caching ] プロパティ
オブジェクトがデータキャッシュを使用するかどうかを指定します。
[ Check For New Data ] プロパティ
キャッシュされたデータを使用するかどうかを示したり、データが変更されたかどうかをサーバーに問い合わせたりします。
メニューが作成されると、ツリー状のインターフェースを使用して、表示させたいアイテムを追加し、必要に応じてプロパティを調整できます。
Menu ノードのプロパティ
ツリーのメニューアイテムを選択すると、次のプロパティを使用できます。
[ Title ] プロパティ
メニューのタイトルです。
[ Background ] プロパティ
メニューの背景画像です。Image オブジェクトである必要があります。
[ Header ] プロパティ
メニューのヘッダー画像です。Image オブジェクトである必要があります。
[ Class ] プロパティ
メニューのテーマクラスです。
[ Control ] プロパティ
[ List ] 、 [ Tab ] 、 [ Table ] のいずれかを指定できます。
[ Tabs Distribution ] プロパティ
[ Control ] プロパティの値が [ Tabs ] の場合にのみ表示されます。メニューの Tab コントロールでタブのオプションを配置する方法を示します。有効な値は次のとおりです。 [ Platform Default ] 、 [ Fixed Size ] 、 [ Scroll ] 。
[
Fixed
Size
] は、コントロールのオプションが少ない (最大で 5 個の) 場合に適しています。この場合、それぞれタブコントロール内で同じ幅になります。これに対して、 [
Scroll
] では、画像とキャプションに応じて各オプションに適切な幅が決まります。このオプションでは、オプション数が画面の幅を超えた場合に、タブコントロールをスクロールできます。
メニューのタブコントロールは Android のみが対象で、iOS アプリケーションでは常に [
Fixed Size
] と同様の動作になります。
Appearance グループ
Show Applications Bars
アプリケーションバーを有効または無効にします。
Application Bars Class
アプリケーションのテーマクラスです。
Show Ads
(1)
広告を有効または無効にします。
Ads Position
(1)
広告の位置を示します。
Items ノードのプロパティ
アイテムは、メニューを構成するエレメントです (通常、
Transaction オブジェクト
または パネルに関連付けられた Work With )。新しいアイテムを追加するには、フォルダビューからオブジェクトをドラッグして、メニューの Items ノードにドロップします。Items ノードを右クリックし、アクションを追加することもできます。
各アイテムには次のプロパティがあります:
[ Name ] プロパティ
オプションの名前です。この名前が [ イベント ] タブのアクションとして参照されます。
[ Description ] プロパティ
オプションの説明です。値が空の場合はプロパティ名が使用されます。メニューで空の説明が必要な場合は、プロパティに空白スペースを追加します。
[ Image ] プロパティ
オプションに使用するアイコンです。Image オブジェクトである必要があります。Menu ノードの [ Control ] プロパティが [ Tabs ] に設定されている場合、iOS および Android では、画像ファイル形式を
PNG
にする必要があり、この形式の
透過性
のみ考慮されます。
[ Class ] プロパティ
オプションに使用する MenuItem テーマクラスです。
例
注
(1)
GeneXus 15 Upgrade 10
以降では廃止されています (使用できなくなりました)。
GeneXus 16 Upgrade 2
以降でメニューオプションにタブコントロールを使用する場合は、ActivePageChanged イベントと [ Menu.ActivePage ] プロパティをオブジェクトイベントに使用できます。
iOS では、メニューをタブとして表示できるのはメインオブジェクトのみです。Menu がアプリケーションのメインオブジェクトでなく、 [ Control ] プロパティが Tabs に設定されている場合は、List として表示されます。これは、
Apple の Human Interface Guidelines
に準拠するためです。Human Interface Guidelines では、次のように記述されています。
一般に、
タブバーは、アプリケーションレベルで情報を整理するために使用します
。タブバーは、情報の階層を圧縮し、同等の地位にある情報の複数のカテゴリあるいはモードに一度にアクセスできるようにするための優れた手段の 1 つです。
...
タブバーはアプリケーションのグローバルナビゲーションを可能にするものなので、
常に表示されている必要があります
。
参考情報
メニューを表示する複数の方法
メニューイベントからのオブジェクトの呼び出し
Theme オブジェクト
動画
モバイルアプリケーションの概念モデル