## Tcl8.6.17/Tk8.6.17 Documentation > Tk C API > ConfigWind

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    Tk_ConfigureWindow, Tk_MoveWindow, Tk_ResizeWindow, Tk_MoveResizeWindow, Tk_SetWindowBorderWidth, Tk_ChangeWindowAttributes, Tk_SetWindowBackground, Tk_SetWindowBackgroundPixmap, Tk_SetWindowBorder, Tk_SetWindowBorderPixmap, Tk_SetWindowColormap, Tk_DefineCursor, Tk_UndefineCursor — 窓の構成設定項目や属性を変更する change window configuration or attributes
  SYNOPSIS
    #include <tk.h>
    Tk_ConfigureWindow(tkwin, valueMask, valuePtr)
    Tk_MoveWindow(tkwin, x, y)
    Tk_ResizeWindow(tkwin, width, height)
    Tk_MoveResizeWindow(tkwin, x, y, width, height)
    Tk_SetWindowBorderWidth(tkwin, borderWidth)
    Tk_ChangeWindowAttributes(tkwin, valueMask, attsPtr)
    Tk_SetWindowBackground(tkwin, pixel)
    Tk_SetWindowBackgroundPixmap(tkwin, pixmap)
    Tk_SetWindowBorder(tkwin, pixel)
    Tk_SetWindowBorderPixmap(tkwin, pixmap)
    Tk_SetWindowColormap(tkwin, colormap)
    Tk_DefineCursor(tkwin, cursor)
    Tk_UndefineCursor(tkwin)
  引数 ARGUMENTS
    Tk_Window tkwin (入力in)
    unsigned int valueMask (入力in)
    XWindowChanges *valuePtr (入力in)
    int x (入力in)
    int y (入力in)
    int width (入力in)
    int height (入力in)
    int borderWidth (入力in)
    XSetWindowAttributes *attsPtr (入力in)
    unsigned long pixel (入力in)
    Pixmap pixmap (入力in)
    Colormap colormap (入力in)
    Tk_Cursor cursor (入力in)
  説明 DESCRIPTION
  瑕疵 BUGS
  SEE ALSO
  KEYWORDS

### NAME

Tk_ConfigureWindow, Tk_MoveWindow, Tk_ResizeWindow, Tk_MoveResizeWindow, Tk_SetWindowBorderWidth, Tk_ChangeWindowAttributes, Tk_SetWindowBackground, Tk_SetWindowBackgroundPixmap, Tk_SetWindowBorder, Tk_SetWindowBorderPixmap, Tk_SetWindowColormap, Tk_DefineCursor, Tk_UndefineCursor — 窓の構成設定項目や属性を変更する change window configuration or attributes

### SYNOPSIS

#include <tk.h>
Tk_ConfigureWindow(tkwin, valueMask, valuePtr)
Tk_MoveWindow(tkwin, x, y)
Tk_ResizeWindow(tkwin, width, height)
Tk_MoveResizeWindow(tkwin, x, y, width, height)
Tk_SetWindowBorderWidth(tkwin, borderWidth)
Tk_ChangeWindowAttributes(tkwin, valueMask, attsPtr)
Tk_SetWindowBackground(tkwin, pixel)
Tk_SetWindowBackgroundPixmap(tkwin, pixmap)
Tk_SetWindowBorder(tkwin, pixel)
Tk_SetWindowBorderPixmap(tkwin, pixmap)
Tk_SetWindowColormap(tkwin, colormap)
Tk_DefineCursor(tkwin, cursor)
Tk_UndefineCursor(tkwin)

### 引数 ARGUMENTS

Tk_Window tkwin (入力in)
  窓の為の字句｡ Token for window.

unsigned int valueMask (入力in)
  CWX や CWBorderPixel の様な値の論理和された櫛､使用すべきは *valuePtr か *attsPtr のどちらの欄かを示している｡　 OR-ed mask of values like CWX or CWBorderPixel, indicating which fields of *valuePtr or *attsPtr to use.

XWindowChanges *valuePtr (入力in)
  valueMask によって選択された構成設定の假引数の為の新しい値を含む構造を指す｡ valueMask によって選択されない欄は無視される｡　 Points to a structure containing new values for the configuration parameters selected by valueMask. Fields not selected by valueMask are ignored.

int x (入力in)
  tkwin の親の内部の tkwin の左上の画素の新しい x-座標(縁があれば､含む)｡　 New x-coordinate for tkwin's top left pixel (including border, if any) within tkwin's parent.

int y (入力in)
  tkwin の親の内部の tkwin の左上の画素の新しい y-座標(縁があれば､含む)｡　 New y-coordinate for tkwin's top left pixel (including border, if any) within tkwin's parent.

int width (入力in)
  tkwinの為の新しい巾(内法､縁を含まない)｡　 New width for tkwin (interior, not including border).

int height (入力in)
  tkwinの為の新しい高さ(内法､縁を含まない)｡　 New height for tkwin (interior, not including border).

int borderWidth (入力in)
  tkwinの縁の為の新しい巾｡　　 New width for tkwin's border.

XSetWindowAttributes *attsPtr (入力in)
  valueMask 引数によって与えられた属性の為の新しい値を含む構造を指す｡valueMask によって選択されない属性は無視される｡　 Points to a structure containing new values for the attributes given by the valueMask argument. Attributes not selected by valueMask are ignored.

unsigned long pixel (入力in)
  窓の為の新しい背景又は縁の色｡　 New background or border color for window.

Pixmap pixmap (入力in)
  tkwin の背景又は縁の為に使用する新しい画素地図｡ 警告: Xlib 呼出しに応じて､必ずしもすぐさま削除されるとは限らない｡下を参照されたい｡ New pixmap to use for background or border of tkwin. WARNING: cannot necessarily be deleted immediately, as for Xlib calls. See note below.

Colormap colormap (入力in)
  tkwinの為に使用する新しい色地図｡　 New colormap to use for tkwin.

Tk_Cursor cursor (入力in)
  tkwin の為に使用する新しい遊走子｡もし､None が指定されている場合､ tkwin は自身の遊走子を有さない､その親の遊走子を使用することになる｡　 New cursor to use for tkwin. If None is specified, then tkwin will not have its own cursor; it will use the cursor of its parent.

### 説明 DESCRIPTION

これ等の手続函数は X 外部函数の手続函数と似た名前である､譬えば XConfigureWindow ｡それぞれの上記の手続函数は対応する X 手続函数を呼び､窓についての Tk の局部構造内の構成設定情報も保存する｡これは情報に対し､応用譜によって､X 中央集中処理装置に接触する必要なしに､素早く取戻されることを許容する( Tk_X や Tk_Height のようなマクロを使用して)｡更に､もし X 窓が実際 tkwin の為に作成されていない場合､これ等の手続函数は X 操作を発生しないか起動される行事処理を惹き起こさない; 後に窓が作成された時､保存された情報は窓の構成設定に使われる｡ These procedures are analogous to the X library procedures with similar names, such as XConfigureWindow. Each one of the above procedures calls the corresponding X procedure and also saves the configuration information in Tk's local structure for the window. This allows the information to be retrieved quickly by the application (using macros such as Tk_X and Tk_Height) without having to contact the X server. In addition, if no X window has actually been created for tkwin yet, these procedures do not issue X operations or cause event handlers to be invoked; they save the information in Tk's local structure for the window; when the window is created later, the saved information will be used to configure the window.

これ等の手続函数が何を行い､その引数を如何に使うかに就いての詳細は X 外部函数説明書を参照されたい｡ See the X library documentation for details on what these procedures do and how they use their arguments.

手続函数 Tk_ConfigureWindow, Tk_MoveWindow, Tk_ResizeWindow, Tk_MoveResizeWindow, and Tk_SetWindowBorderWidth 内で､もしtkwin が内部窓である場合､手続函数が帰る前に､構成設定行事に拘わる行事処理機能はすぐさま起動される｡もし tkwin が頂上水準の窓の場合､ X が要求を見てそのための行事を返した後に行事処理機能は後で起動されることになる｡ In the procedures Tk_ConfigureWindow, Tk_MoveWindow, Tk_ResizeWindow, Tk_MoveResizeWindow, and Tk_SetWindowBorderWidth, if tkwin is an internal window then event handlers interested in configure events are invoked immediately, before the procedure returns. If tkwin is a top-level window then the event handlers will be invoked later, after X has seen the request and returned an event for it.

Tk を使う応用譜は XConfigureWindow の様な手続函数を直接呼ぶべきではない; それらは常に､対応する Tk 手続函数を使うべきである｡ Applications using Tk should never call procedures like XConfigureWindow directly; they should always use the corresponding Tk procedures.

窓の寸法と位置はその窓の為の適切な幾何管理譜によってのみ修正されるべきであり､窓自身で行うべきではない(但し､頂上水準の窓の移動は Tk_MoveToplevelWindow を参照されたい)｡ The size and location of a window should only be modified by the appropriate geometry manager for that window and never by a window itself (but see Tk_MoveToplevelWindow for moving a top-level window).

使用者は窓の棚順の変更に Tk_ConfigureWindow を使うべきではない(valueMask は CWSibling or CWStackMode ビットを含まない)｡棚順を変更するためには Tk_RestackWindow を使うべきである｡ You may not use Tk_ConfigureWindow to change the stacking order of a window (valueMask may not contain the CWSibling or CWStackMode bits). To change the stacking order, use the procedure Tk_RestackWindow.

もし新しい画素地図が tkwin の親のものとは異なり､又 tkwin は未だTK_COLORMAP_WINDOWS 特性内には無い場合､手続函数 Tk_SetWindowColormap は自動的に tkwin をその最も近い頂上水準の祖先のTK_COLORMAP_WINDOWS 特性に入れる｡ The procedure Tk_SetWindowColormap will automatically add tkwin to the TK_COLORMAP_WINDOWS property of its nearest top-level ancestor if the new colormap is different from that of tkwin's parent and tkwin is not already in the TK_COLORMAP_WINDOWS property.

### 瑕疵 BUGS

Tk_SetWindowBackgroundPixmap と Tk_SetWindowBorderPixmap はその Xlib の相当品とは幾らか異なり､これ等手続函数の一つを呼出した後にすぐさま pixmap 引数を､削除する必要は無い｡これはtkwin の窓は呼出し時には未だ実在しないかもしれず､その場合画素地図は後にtkwin の窓が実際作成される時に単に保存され使用される｡もし画素地図を削除したい場合､ Tk_MakeWindowExist を最初に呼び､ tkwinの 窓が実在し画素地図が X 集中処理機能に渡されたことを確認すべき｡ Tk_SetWindowBackgroundPixmap and Tk_SetWindowBorderPixmap differ slightly from their Xlib counterparts in that the pixmap argument may not necessarily be deleted immediately after calling one of these procedures. This is because tkwin's window may not exist yet at the time of the call, in which case pixmap is merely saved and used later when tkwin's window is actually created. If you wish to delete pixmap, then call Tk_MakeWindowExist first to be sure that tkwin's window exists and pixmap has been passed to the X server.

cursor 引数を Tk_DefineCursor に渡す為に同様の問題が生じる｡解決策は上述の画素地図の為のと同じ: 遊走子の解除の前に Tk_MakeWindowExist を呼ぶべきである｡ A similar problem occurs for the cursor argument passed to Tk_DefineCursor. The solution is the same as for pixmaps above: call Tk_MakeWindowExist before freeing the cursor.

### SEE ALSO

Tk_MoveToplevelWindow, Tk_RestackWindow

### KEYWORDS

attributes, border, color, configure, height, pixel, pixmap, width, window, x, y
Copyright © 1990-1993 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.