名称

MrmFetchInterfaceModule − uid 階層構造の中のインターフェースモジュールで定義されたすべての widget をフェッチします

形式

#include <Xm/Intrinsics>
#include <Mrm/MrmPublic.h>
Cardinal MrmFetchInterfaceModule(hierarchy_id, module_name, parent_widget, widget)

MrmHierarchy hierarchy_id;
char ∗module_name;
Widget parent_widget;
Widget ∗widget;

解説

MrmFetchInterfaceModule 関数は、 uid 階層構造のなかの uil モジュール中に定義されたすべての widget をフェッチします。 通常は各アプリケーションはインターフェースを定義する 1 つ以上のモジュールを持っています。 アプリケーションが要求するすべての widget を初期化するために、それぞれの widget をフェッチしなければなりません。 アプリケーションはすべての widget を 1 つのモジュールの中で定義する必要はありません。 モジュールがメインウィンドウ widget を定義していれば、MrmFetchInterfaceModule はその widget ID を返します。 モジュールの中にメインウィンドウ widget が 1 つも含まれていなければ、MrmFetchInterfaceModule は NULL を返し、widget は実現されません。 生成コールバックを用いることによって、アプリケーションはメインウィンドウ widget 以外の widget の ID を得ることができます。

hierarchy_idインターフェース定義を含む uid 階層構造の ID を指定します。 hierarchy_id は MrmOpenHierarchy を呼び出したときのリターン値です。

module_name
uil モジュールヘッダにおいて指定したインターフェースモジュールの名前を指定します。 慣例で、この名前には普通アプリケーションの一般名を用います。

parent_widget
モジュールからフェッチされる最上位 widget の親の widget の ID を指定します。 最上位 widget とは、uil モジュールの中で親が指定されていないような widget のことです。 親の widget は通常は XtInitialize で返されるトップレベルの widget です。

widgetuil モジュールに出てくる最後のメインウィンドウ widget の ID を返します。 メインウィンドウ widget が見つからなかった場合は、NULL を返します。

リターン値

この関数は、状態を示す以下の定数のうちのいずれかを返します。

MrmSUCCESS関数が正常に実行された。

MrmFAILURE関数の実行が失敗した。

MrmNOT_FOUND
インターフェースモジュールかまたは最上位 widget が見つからなかった。

NEWS-OSRelease 4.1C