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

### 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_WindowId, Tk_Parent, Tk_Display, Tk_DisplayName, Tk_ScreenNumber, Tk_Screen, Tk_X, Tk_Y, Tk_Width, Tk_Height, Tk_Changes, Tk_Attributes, Tk_IsContainer, Tk_IsEmbedded, Tk_IsMapped, Tk_IsTopLevel, Tk_ReqWidth, Tk_ReqHeight, Tk_MinReqWidth, Tk_MinReqHeight, Tk_InternalBorderLeft, Tk_InternalBorderRight, Tk_InternalBorderTop, Tk_InternalBorderBottom, Tk_Visual, Tk_Depth, Tk_Colormap, Tk_Interp — Tk の局所データ構造からの情報を取出す｡ retrieve information from Tk's local data structure
  SYNOPSIS
    #include <tk.h>
    Window
    Tk_WindowId(tkwin)
    Tk_Window
    Tk_Parent(tkwin)
    Display *
    Tk_Display(tkwin)
    const char *
    Tk_DisplayName(tkwin)
    int
    Tk_ScreenNumber(tkwin)
    Screen *
    Tk_Screen(tkwin)
    int
    Tk_X(tkwin)
    int
    Tk_Y(tkwin)
    int
    Tk_Width(tkwin)
    int
    Tk_Height(tkwin)
    XWindowChanges *
    Tk_Changes(tkwin)
    XSetWindowAttributes *
    Tk_Attributes(tkwin)
    int
    Tk_IsContainer(tkwin)
    int
    Tk_IsEmbedded(tkwin)
    int
    Tk_IsMapped(tkwin)
    int
    Tk_IsTopLevel(tkwin)
    int
    Tk_ReqWidth(tkwin)
    int
    Tk_ReqHeight(tkwin)
    int
    Tk_MinReqWidth(tkwin)
    int
    Tk_MinReqHeight(tkwin)
    int
    Tk_InternalBorderLeft(tkwin)
    int
    Tk_InternalBorderRight(tkwin)
    int
    Tk_InternalBorderTop(tkwin)
    int
    Tk_InternalBorderBottom(tkwin)
    Visual *
    Tk_Visual(tkwin)
    int
    Tk_Depth(tkwin)
    Colormap
    Tk_Colormap(tkwin)
    Tcl_Interp *
    Tk_Interp(tkwin)
  引数 ARGUMENTS
    Tk_Window tkwin (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

Tk_WindowId, Tk_Parent, Tk_Display, Tk_DisplayName, Tk_ScreenNumber, Tk_Screen, Tk_X, Tk_Y, Tk_Width, Tk_Height, Tk_Changes, Tk_Attributes, Tk_IsContainer, Tk_IsEmbedded, Tk_IsMapped, Tk_IsTopLevel, Tk_ReqWidth, Tk_ReqHeight, Tk_MinReqWidth, Tk_MinReqHeight, Tk_InternalBorderLeft, Tk_InternalBorderRight, Tk_InternalBorderTop, Tk_InternalBorderBottom, Tk_Visual, Tk_Depth, Tk_Colormap, Tk_Interp — Tk の局所データ構造からの情報を取出す｡ retrieve information from Tk's local data structure

### SYNOPSIS

#include <tk.h>
Window
Tk_WindowId(tkwin)
Tk_Window
Tk_Parent(tkwin)
Display *
Tk_Display(tkwin)
const char *
Tk_DisplayName(tkwin)
int
Tk_ScreenNumber(tkwin)
Screen *
Tk_Screen(tkwin)
int
Tk_X(tkwin)
int
Tk_Y(tkwin)
int
Tk_Width(tkwin)
int
Tk_Height(tkwin)
XWindowChanges *
Tk_Changes(tkwin)
XSetWindowAttributes *
Tk_Attributes(tkwin)
int
Tk_IsContainer(tkwin)
int
Tk_IsEmbedded(tkwin)
int
Tk_IsMapped(tkwin)
int
Tk_IsTopLevel(tkwin)
int
Tk_ReqWidth(tkwin)
int
Tk_ReqHeight(tkwin)
int
Tk_MinReqWidth(tkwin)
int
Tk_MinReqHeight(tkwin)
int
Tk_InternalBorderLeft(tkwin)
int
Tk_InternalBorderRight(tkwin)
int
Tk_InternalBorderTop(tkwin)
int
Tk_InternalBorderBottom(tkwin)
Visual *
Tk_Visual(tkwin)
int
Tk_Depth(tkwin)
Colormap
Tk_Colormap(tkwin)
Tcl_Interp *
Tk_Interp(tkwin)

### 引数 ARGUMENTS

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

### 説明 DESCRIPTION

Tk_WindowId と上に列挙された他の名前は全てマクロであり､ tkwin についてのTk の局所データ構造から欄を返す｡どのマクロも中央集中処理装置とのどのような相互作用も要求されない; 全てが速いとの仮定は安全である｡ Tk_WindowId and the other names listed above are all macros that return fields from Tk's local data structure for tkwin. None of these macros requires any interaction with the server; it is safe to assume that all are fast.

Tk_WindowId は､ tkwin についての X の識別子を返す､但し､ tkwin に就いての X 窓が未だ作成されていない場合は NULL である｡ Tk_WindowId returns the X identifier for tkwin, or NULL if no X window has been created for tkwin yet.

Tk_Parent は､ tkwin の論理的親に関する Tk's の解析字句を返す｡その親は tkwin が作成された時に指定された解析字句である､か主窓に関しては NULL である｡ Tk_Parent returns Tk's token for the logical parent of tkwin. The parent is the token that was specified when tkwin was created, or NULL for main windows.

Tk_Interp は､ tkwin に束縛された Tcl 解釈実行機能を返すが､不都合がある場合は NULL を返す｡ Tk_Interp returns the Tcl interpreter associated with a tkwin or NULL if there is an error.

Tk_Display は､ tkwin に対応する Xlib の表示構造へのポインターを返す｡Tk_DisplayName は､ tkwin の表示を識別する ASCII 文字列を返す｡Tk_ScreenNumber は tkwin の表示の全ての画面内の tkwin の画面への索引を返す｡ Tk_Screen は tkwin の画面に対応する Xlib 構造へのポインタを返す｡ Tk_Display returns a pointer to the Xlib display structure corresponding to tkwin. Tk_DisplayName returns an ASCII string identifying tkwin's display. Tk_ScreenNumber returns the index of tkwin's screen among all the screens of tkwin's display. Tk_Screen returns a pointer to the Xlib structure corresponding to tkwin's screen.

Tk_X, Tk_Y, Tk_Width, と Tk_Height は､親の中の tkwin の位置と寸法に関する情報を返す｡位置の情報は窓内の左上の画素を参照するか､ある場合は縁を参照する｡幅と高さの情報は縁を含まない窓の内部寸法を参照する｡Tk_Changes は全ての上の情報に幾つかの追加の欄を含む構造へのポインタを返す｡ Tk_Attributes は tkwin の窓の全ての属性を記述している XSetWindowAttributes 構造､譬えば背景画素地図､行事の櫛､等へのポインタを返す(Tk は応用譜による変化としての全ての情報の足跡を保持する)｡註意: X の代りに Tk_ResizeWindow の様な Tk 手続函数を使う応用譜では本質的である､従って､ Tk は更新したデータ構造を保有できる｡ Tk_X, Tk_Y, Tk_Width, and Tk_Height return information about tkwin's location within its parent and its size. The location information refers to the upper-left pixel in the window, or its border if there is one. The width and height information refers to the interior size of the window, not including any border. Tk_Changes returns a pointer to a structure containing all of the above information plus a few other fields. Tk_Attributes returns a pointer to an XSetWindowAttributes structure describing all of the attributes of the tkwin's window, such as background pixmap, event mask, and so on (Tk keeps track of all this information as it is changed by the application). Note: it is essential that applications use Tk procedures like Tk_ResizeWindow instead of X procedures like XResizeWindow, so that Tk can keep its data structures up-to-date.

Tk_IsContainer は､もし tkwin が運搬体である場合には非零の値を返し､ tkwin 内になにか他の応用譜が tkwin.内部に埋込みされている場合は零を返す｡ Tk_IsContainer returns a non-zero value if tkwin is a container, and that some other application may be embedding itself inside tkwin.

Tk_IsEmbedded は､もし tkwin が独立した窓ではない場合には非零の値を返し､埋込みされている場合は零を返す｡ Tk_IsEmbedded returns a non-zero value if tkwin is not a free-standing window, but rather is embedded in some other application.

Tk_IsMapped は､もし tkwin が対応付けされている場合には非零の値を返し､対応付けされていない場合は零を返す｡ Tk_IsMapped returns a non-zero value if tkwin is mapped and zero if tkwin is not mapped.

Tk_IsTopLevel は､もし tkwin が頂上水準の窓(その X 親は画面の根本窓である)である場合には非零の値を返し､頂上水準の窓でない場合は零を返す｡ Tk_IsTopLevel returns a non-zero value if tkwin is a top-level window (its X parent is the root window of the screen) and zero if tkwin is not a top-level window.

Tk_ReqWidth と Tk_ReqHeight は窓の要求された寸法に関する情報を返す｡この値は tkwin に関する Tk_GeometryRequest への最後の呼び出しに対応する｡ Tk_ReqWidth and Tk_ReqHeight return information about the window's requested size. These values correspond to the last call to Tk_GeometryRequest for tkwin.

Tk_MinReqWidth と Tk_MinReqHeight は窓に要求された最小寸法に関する情報を返す｡この値は tkwin に関する Tk_SetMinimumRequestSize への最後の呼び出しに対応する｡ Tk_MinReqWidth and Tk_MinReqHeight return information about the window's minimum requested size. These values correspond to the last call to Tk_SetMinimumRequestSize for tkwin.

Tk_InternalBorderLeft と Tk_InternalBorderRight と Tk_InternalBorderTop と Tk_InternalBorderBottom は tkwin の為に要求された内側の縁の片側の幅を返す､但し､縁の内側が要求されていない場合は 0 を返す｡返る値は単純に tkwin の為に Tk_SetInternalBorder か Tk_SetInternalBorderEx に最後に渡された値である｡ Tk_InternalBorderLeft, Tk_InternalBorderRight, Tk_InternalBorderTop and Tk_InternalBorderBottom return the width of one side of the internal border that has been requested for tkwin, or 0 if no internal border was requested. The return value is simply the last value passed to Tk_SetInternalBorder or Tk_SetInternalBorderEx for tkwin.

Tk_Visual と Tk_Depth と Tk_Colormap は窓の外観の性質の情報を返す｡Tk_Visual は窓に関する外観の型を返し､Tk_Depth は画素単位のビット数を返し､ Tk_Colormap は窓に関する現在の画素地図を返す｡外観の性質は通常無為設定から窓の画面を設定するが､ Tk_SetWindowVisual.を呼出すことにより上書きされる｡ Tk_Visual, Tk_Depth, and Tk_Colormap return information about the visual characteristics of a window. Tk_Visual returns the visual type for the window, Tk_Depth returns the number of bits per pixel, and Tk_Colormap returns the current colormap for the window. The visual characteristics are normally set from the defaults for the window's screen, but they may be overridden by calling Tk_SetWindowVisual.

### KEYWORDS

attributes, colormap, depth, display, height, geometry manager, identifier, mapped, requested size, screen, top-level, visual, width, window, x, y
Copyright © 1990-1993 The Regents of the University of California.
Copyright © 1994-1997 Sun Microsystems, Inc.