名称

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;

引数

displayX サーバへの接続を指定します。

screen_number
ホストサーバ固有のスクリーン番号を指定します。

value_mask指定値の構造体を使って設定される値を指定します。 このマスクはウィンドウの論理和です。

valuesXWindowChanges 構造体を指定します。

wウィンドウを指定します。

解説

XIconifyWindow 関数は 32 フォーマットの WM_CHANGE_STATE ClientMessage イベントおよび IconicState ( クライアント間の通信協定マニュアル の 4.1.4 に記述) の最初のデータエレメント、w に指定されているウィンドウを 指定されたスクリーンのルートウィンドウに送り、 イベントマスクを SubstructureNotifyMask| SUbstructureRedirectMask に設定します。 ウィンドウマネージャがこのメッセージの受信を選択することも、 ウィンドウが通常の状態であれば、 ウィンドウを通常状態からアイコン状態へ変更するためのリクエストとして 扱うこともあります。 WM_CHANGE_STATE 属性を制限できない場合には、 XIconifyWindow はメッセージを送信せず、 ゼロステータスを返します。 クライアントメッセージが無事送られた場合ゼロ以外のステータスを返します。 そうでなければ、ゼロステータスを返します。 XWithdrawWindow 関数は指定ウィンドウをアンマップし、 指定スクリーンのルートウィンドウに形式的な UnmapNotify イベントを送ります。 ウィンドウマネージャがこのメッセージの受信を選択することもでき、 ウィンドウを隠れた状態にするためのリクエストとして扱うこともあります。 あるウィンドウが隠れた状態にある場合、 通常表示でもアイコン表示でも見えません。 UnmapNotify イベントが無事送られると、 ゼロ以外のステータスを返します。 そうでなければ、 ゼロステータスを返します。 XWithdrawWindow は BadWindow エラーを発生することがあります。 XReconfigureWMWindow 関数は指定の最上位ウィンドウ上の ConfigureWindow リクエストを発行します。 スタックモードが変更され、 BadMatch エラーの発生によってリクエストに失敗した場合、 エラーイベントは Xlib にトラップされ、 同じパラメータ構造を持つ形式上の ConfigureRequestEvent が指定ルートウィンドウに送られます。 ウィンドウマネージャはこのイベントの受信を選択することもできますし、 指定ウィンドウを再構成するためのリクエストとして扱うこともあります。 リクエストかイベントが無事送られると、 ゼロ以外のステータスを返します。 それ以外の場合は、ゼロのステータスを返します。 XReconfigureWMWindow は BadValue および BadWindow エラーを発生することがあります。

診断

BadValue 数値がリクエストで定めた範囲から外れています。 引数の範囲が特に指定されていない限り、 引数のタイプで定義された範囲いっぱいが許されます。 二者択一で定義された引数であれば、このエラーが発生する可能性があります。

BadWindow
Window 引数に対する値が定義されたウィンドウに一致しない。

関連事項

XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWindow(3X11), XRaiseWindow(3X11), XMapWindow(3X11), XUnmapWindow(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R