XtPopdown

Section: XT FUNCTIONS (3Xt)
Updated: Release 6.3
Index xjman/web INDEX
 

名前

XtPopdown, XtCallbackPopdown - ポップアップのアンマップ  

書式

void XtPopdown(popup_shell)

      Widget popup_shell;

void XtCallbackPopdown(w, client_data, call_data)

      Widget w;

      XtPointer client_data;

      XtPointer call_data;

void MenuPopdown(shell_name)

      String shell_name;  

引き数

call_data
コールバックデータを指定。 これは、この手続きには使用されない。
client_data
XtPopdownID 構造体へのポインタを指定。
popup_shell
ポップダウンするウィジェットシェルを指定。
shell_name
ポップダウンするウィジェットシェルの名前を指定。
w
ウィジェットを指定。
 

説明

関数 XtPopdown の動作は以下である:
*
XtCheckSubclass を呼び、popup_shell が Shell のサブクラスであることを確認する。
*
popup_shell が現在ポップアップされていることを確認する。 ポップアップされていなければ、エラーを起こす。
*
popup_shell のウィンドウをアンマップする。
*
popup_shell の grab_kind が XtGrabNonexclusive または XtGrabExclusive ならば、 XtRemoveGrab を呼ぶ。
*
ポップアップシェルの popped_up フィールドに False をセットする。
*
シェルの popdown_callback リストのコールバック手続きを呼ぶ。

関数 XtCallbackPopdown は、クライアントデータのパラメータを XtPopdownID へのポインタにキャストする:


typedef struct {
     Widget shell_widget;
     Widget enable_widget;
} XtPopdownIDRec, *XtPopdownID;


shell_widget はポップダウンさせるポップアップシェルであり、 enable_widget はこれをポップアップさせるときに使われたウィジェットであ る。

関数 XtCallbackPopdown は、指定された shell_widget を使って XtPopdown を呼び、その後で enable_widget が再びイベントに反応できるようにするた め XtSetSensitive を呼ぶ。

シェルの名前が与えられなかった場合、 MenuPopdown はトランスレーションが指定されているウィジェットを使って XtPopdown を呼ぶ。 shell_name がトランスレーションテーブル内で指定されている場合、 MenuPopdown はウィジェットツリーを検索してシェルを見つけようとする。この検索は、こ の関数が呼び出されたウィジェットの親ウィジェットから始められる。 その親ウィジェットの子ウィジェットであるポップアップの中に指定した名前 を持つシェルが見つかった場合、そのシェルはポップダウンされる。 そうでない場合には、必要に応じて繋がっている親ウィジェットを上に向かっ て参照してゆく。 MenuPopdown がアプリケーションのトップレベルのシェルウィジェットに達し、しかもマッ チするシェルが見つからなかった場合には、この関数はエラーを起こす。  

関連項目

XtCreatePopupShell(3Xt), XtPopup(3Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface


 

Index

名前
書式
引き数
説明
関連項目

This document was created by man2html, using the manual pages.
Time: 15:56:34 GMT, February 12, 2001