XIconifyWindow(3X11) — NEWS-OS Programmer’s Manual

関数

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

診断

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

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

Museum

Related Articles

XIconifyWindow(3X11) — NEWS-OS Programmer’s Manual

関数

シンタックス

引数

解説

診断

関連事項