XIconifyWindow(3X11)

名前
XIconifyWindow, XWithdrawWindow, XReconfigureWMWindow - トップレベルウィンドウの操作

書式
Status XIconifyWindow(display, w, screen_number)
      Display *display;
      Window w;
      int screen_number;

Status XWithdrawWindow(display, w, screen_number)
      Display *display;
      Window w;
      int screen_number;

Status XReconfigureWMWindow(display, w, screen_number, value_mask, values)
      Display *display;
      Window w;
      int screen_number;
      unsigned int value_mask;
      XWindowChanges *values;

引き数

display
    X サーバへの接続を指定。

screen_number
    ホストサーバ上の適切なスクリーン番号を指定。

value_mask
    構造体の情報を使ってどの値をセットするのかを指定。 このマスクは有効なウィンドウ設定ビット値のビットごとの論理和である。

values
    構造体を指定。

w   ウィンドウを指定。

説明
関数 は 最初の要素が (Inter-Client Communication Conventions Manual の 4.1.4 節に説明 がある)であり、引き数 w のウィンドウがセットされた
 WM_CHANGE_STATE イベントを、指定されたスクリーンのルートウィンドウに送る。送る際のフォー マットは 32 であり、イベントマスクには がセットされている。 ウィンドウマネージャはこのメッセージを受け取り、ウィンドウが通常の状態 ならば、このメッセージはウィンドウを通常の状態からアイコン化された状態 に変化させるリクエストとして扱われる。 WM_CHANGE_STATE プロパティを取得できなかった場合、 はメッセージを送信せず、ゼロのステータスを返す。 この関数はクライアントメッセージの送信に成功した時にゼロでないステータ スを返し、失敗した場合にゼロのステータスを返す。

関数 は指定したウィンドウをアンマップし、偽の を指定したスクリーンのルートウィンドウに送る。 ウィンドウマネージャはこのメッセージを受け取り、これをウィンドウをアン マップ状態に変化させるリクエストとして扱う。 ウィンドウがアンマップ状態にある時は、通常のウィンドウもアイコンも画面 上には現われない。 を正常に送信できた場合は、この関数はゼロでないステータスを返し、そうで ない場合はゼロのステータスを返す。

はエラー を起こすことがある。

関数 は指定したトップレベルウィンドウに リクエストを発行する。 スタックのモードが変化し、リクエストが エラーで失敗した場合に、このエラーは Xlib にトラップされ、同じ設定パラ メータを持つ偽の イベントが指定したウィンドウのルートウィンドウに送られる。 ウィンドウマネージャはこのイベントを受け取り、これを指定したウィンドウ を再設定するリクエストとして扱う。 リクエストやイベントを正常に送信できた場合、この関数はゼロでないステー タスを返し、そうでなければゼロのステータスを返す。

はエラー を起こすことがある。

返り値

指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対
    して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。

引き数 Window の値が、定義されている Window を指していない。

関連項目
XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWindow(3X11), XRaiseWindow(3X11), XMapWindow(3X11), XUnmapWindow(3X11)
Xlib - C Language X Interface