XSetNormalHints(3X11) — NEWS-OS Programmer’s Manual
名称
XSetNormalHints, XGetNormalHints - 正規状態のヒントを設定、または獲得 します
形式
XSetNormalHints(display, w, hints)
Display ∗display;
Window w;
XSizeHints ∗hints; Status XGetNormalHints(display, w, hints_return)
Display ∗display;
Window w;
XSizeHints ∗hints_return;
引数
displayX サーバへのコネクションを指定します。
hints正規状態内のウィンドウのサイズヒントを指すポインタを指定します。
hints_return正規状態内のウィンドウのサイズヒントを返します。
wウィンドウを指定します。
解説
XSetNormalHints 関数は、指定されたウィンドウのサイズヒント構造体を設定します。 アプリケーションは、 XSetNormalHints を使用して、ウィンドウマネージャに、そのウィンドウに的確なサイズや位 置を知らせます。 さらに、 それ自身を移動、またはサイズ変更したいアプリケーションは、 XSetNormalHints を呼び出し、移動またはサイズ変更のために、 Xlib を直接呼び出すのと同じく、新しく希望する位置およびサイズを指定し ます。 これは、ウィンドウマネージャは、変更された構成要求は無視するが、プロ パティの変更には留意するからです。 サイズヒントを設定するために、アプリケーションは、値をヒント構造体中 の適切なメンバに割り当てるだけでなく、どの情報が存在し、それはどこか らのものかを示すために、その構造体のフラグメンバを設定しなければなり ません。 XSetNormalHints の呼び出しは、どの構造体メンバが値を割り当てられているのかを示すために、 フラグメンバが設定されるまでは意味がありません。 .PN XSetNormalHints は、 BadAlloc および BadWindow エラーを生じることがあります。 XGetNormalHints 関数は、正規の状態で、ウィンドウのサイズヒントを返します。 成功した場合は、 0 でない値を返し、アプリケーションが、このウィンドウ について正規のサイズヒントを指定しない場合は、 0 を返します。 .PN XGetNormalHints は、 BadWindow エラーを生じることがあります。
特性
WM_NORMAL_HINTS
診断
BadAlloc サーバが要求されたリソース、またはサーバメモリの割当てに失敗した。
BadWindow
Window 引数の値が定義された Window を指さない。
関連事項
XSetCommand(3X11), XSetIconName(3X11), XSetIconSizeHints(3X11), XSetSizeHints(3X11), XSetStandardProperties(3X11), XSetWMHints(3X11), XSetZoomHints(3X11), XStoreName(3X11)
Xlib − C Language X Interface
NEWS-OSRelease 4.2.1R