名称

XmCreatePulldownMenu — RowColumn  widget 簡易生成関数

形式

#include <Xm/RowColumn.h> Widget XmCreatePulldownMenu (parent, name, arglist, argcount)
Widgetparent;
Stringname;
ArgListarglist;
Cardinalargcount;

解説

XmCreatePulldownMenu は XmMENU_PULLDOWN 型の RowColumn  widget のインスタンスを生成し、それに関する widget ID を返します。 この関数で MenuPane を生成すると、MenuShell widget が MenuPane の親として自動的に生成されます。 parent パラメータによって指定される widget が Popup または Pulldown MenuPane であれば、MenuShell  widget はその parent の MenuShell の子として生成されます。 それ以外の時は parent で指定された widget の子として生成されます。

XmCreatePulldownMenu は、Pulldown MenuPane として動作するように構成された RowColumn  widget を生成するための簡易関数として供給され、独立した widget クラスとしてはインプリメントされていません。

Pulldown MenuPane は、アプリケーションで禁止しなければ、3 次元の影を表示します。 この影は、MenuPane の縁の周囲に表示されます。

Pulldown MenuPane は、CascadeButton または CascadeButtonGadget に取り付けられるサブメニューを生成する時に用いられます。 Pulldown Menu システムの一部 (MenuBar) となっているすべての MenuPane や、OptionMenu に関連する MenuPane、Popup MenuPane からカスケードする MenuPane すべてに関して、同じことが言えます。 Option Menu に伴う Pulldown MenuPane は、 OptionMenu が生成される前に生成しなければなりません。

Pulldown MenuPane は、MenuBar、Popup MenuPane、Pulldown MenuPane、OptionMenu の中にある CascadeButton または CascadeButtonGadget に取り付けられなければなりません。 これにはボタンのリソース XmNsubMenuId を使用します。

Pulldown MenuPane とその親の間には MenuShell widget が要求されます。 アプリケーションが Pulldown MenuPane を生成するためにこの簡易関数を使うと、MenuShell が MenuPane の実際の親として自動的に生成されます。 それ以外の時はアプリケーションの責任で MenuShell  widget を生成することになります。

メニューに組み入れた時に正しく機能させるために、Pulldown MenuPane の階層構造を考慮する必要があります。 この階層構造は以下のように、作成されるメニューシステムに依存します:

•Pulldown MenuPane が MenuBar からプルダウンされる場合、その parent は MenuBar でなければなりません。

•Pulldown MenuPane が Popup または他の Pulldown MenuPane からプルダウンされる場合、その parent は Popup または Pulldown MenuPane でなければなりません。

•Pulldown MenuPane が OptionMenu からプルダウンされる場合、その parent は OptionMenu の親と同じでなければなりません。

parent親 widget の ID を指定します。

name生成される widget の名前を指定します。

arglist引数のリストを指定します。

argcount引数のリスト (arglist) の中の「属性 / 値」の組の数を指定します。

RowColumn の完全な定義とそれに関連するリソースについては、XmRowColumn(3XM) を参照してください。

リターン値

RowColumn  widget の ID を返します。

関連事項

XmCascadeButton(3XM), XmCascadeButtonGadget(3XM), XmCreateOptionMenu(3XM), XmCreatePopupMenu(3XM), XmCreatePulldownMenu(3XM), XmMenuShell(3XM), XmRowColumn(3XM)

NEWS-OSRelease 4.2.1R