## Tcl8.6.17/Tk8.6.17 Documentation > Tk Commands > wm

### 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
    wm — 窓管理譜との通話 Communicate with window manager
  構文 SYNOPSIS
  説明 DESCRIPTION
    wm aspect window ?minNumer minDenom maxNumer maxDenom?
    wm attributes window
    wm attributes window ?option?
    wm attributes window ?option value option value...?
      -alpha
      -fullscreen
      -topmost
      -disabled
      -toolwindow
      -transparentcolor
      -modified
      -notify
      -titlepath
      -transparent
      -type
        desktop
        dock
        toolbar
        menu
        utility
        splash
        dialog
        dropdown_menu
        popup_menu
        tooltip
        notification
        combo
        dnd
        normal
      -zoomed
    wm client window ?name?
    wm colormapwindows window ?windowList?
    wm command window ?value?
    wm deiconify window
    wm focusmodel window ?active|passive?
    wm forget window
    wm frame window
    wm geometry window ?newGeometry?
    wm grid window ?baseWidth baseHeight widthInc heightInc?
    wm group window ?pathName?
    wm iconbitmap window ?bitmap?
      wm iconbitmap window ?-default? ?image?
    wm iconify window
    wm iconmask window ?bitmap?
    wm iconname window ?newName?
    wm iconphoto window ?-default? image1 ?image2 ...?
    wm iconposition window ?x y?
    wm iconwindow window ?pathName?
    wm manage widget
    wm maxsize window ?width height?
    wm minsize window ?width height?
    wm overrideredirect window ?boolean?
    wm positionfrom window ?who?
    wm protocol window ?name? ?command?
    wm resizable window ?width height?
    wm sizefrom window ?who?
    wm stackorder window ?isabove|isbelow window?
    wm state window ?newstate?
    wm title window ?string?
    wm transient window ?container?
    wm withdraw window
  GEOMETRY MANAGEMENT
  GRIDDED GEOMETRY MANAGEMENT
  瑕疵 BUGS
  用例 EXAMPLES
  SEE ALSO
  KEYWORDS

### NAME

wm — 窓管理譜との通話 Communicate with window manager

### 構文 SYNOPSIS

wm option window ?args?

### 説明 DESCRIPTION

wm 命令は､窓の表題､その幾何､寸法変更される際の増分の様な事柄の管理の為に､窓管理譜との対話に使われる｡ wm 命令は option 引数に従って幾つもの異なる形式をとる｡全ての形式は少なくとも一つの追加的引数 window を取ることを要求し､又､それは 頂上水準の窓の経路名でなければならない｡ The wm command is used to interact with window managers in order to control such things as the title for a window, its geometry, or the increments in terms of which it may be resized. The wm command can take any of a number of different forms, depending on the option argument. All of the forms expect at least one additional argument, window, which must be the path name of a top-level window.

wm 命令に対する公式の形式は次の通り: The legal forms for the wm command are:

wm aspect window ?minNumer minDenom maxNumer maxDenom?
  もし minNumer と minDenom と maxNumer と maxDenom が全て指定されている場合､それらは窓管理譜に渡され､窓管理譜は window に就いて許容される縦横比の範囲を強制する為に使う｡窓の縦横比(幅/長さ)は minNumer/minDenom と maxNumer/maxDenom との間になる様拘束される｡もしminNumer 等全てが空白文字として指定されると､どの様な既存の縦横比の制限も除去される｡もし､ minNumer 等が指定された場合､命令は空文字列を返す｡そうでない場合､現在の値の minNumer と minDenom と maxNumer と maxDenom の４つの要素を含む Tcl リストを返す(もし有効な縦横比の制限がない場合､空文字列が返される)｡ If minNumer, minDenom, maxNumer, and maxDenom are all specified, then they will be passed to the window manager and the window manager should use them to enforce a range of acceptable aspect ratios for window. The aspect ratio of window (width/length) will be constrained to lie between minNumer/minDenom and maxNumer/maxDenom. If minNumer etc. are all specified as empty strings, then any existing aspect ratio restrictions are removed. If minNumer etc. are specified, then the command returns an empty string. Otherwise, it returns a Tcl list containing four elements, which are the current values of minNumer, minDenom, maxNumer, and maxDenom (if no aspect restrictions are in effect, then an empty string is returned).

wm attributes window

wm attributes window ?option?

wm attributes window ?option value option value...?
  この副命令は､窓に関連するOS固有の属性を返すか､設定するか､を行う｡第一の形式はOS固有の､旗印とその値のリストを返す｡第二の形式は指定した項目の値を返す｡第三の形式は一つ或はそれ以上の値を設定する｡値は次の通り: This subcommand returns or sets platform specific attributes associated with a window. The first form returns a list of the platform specific flags and their values. The second form returns the value for the specific option. The third form sets one or more of the values. The values are as follows:

  全てのOSは次の属性に対応できる(但し X11 使用者は下の註意を参照されたい): All platforms support the following attributes (though X11 users should see the notes below):

  -alpha
    頂上水準のアルファー透明水準を設定する｡ 0.0 (完全透明) から 1.0 (不透明)の値を受容れる｡この範囲外の値は抑制される｡対応しない版では -alpha 値は 1.0 に留まる｡ Specifies the alpha transparency level of the toplevel. It accepts a value from 0.0 (fully transparent) to 1.0 (opaque). Values outside that range will be constrained. Where not supported, the -alpha value remains at 1.0.

  -fullscreen
    画面全体を使う様式で窓を置く､縁はなし､且つ､一般使用領域を覆う様に置く(即ち､ Windows での開始指示項目聚と担当帯､ OSX での切替えと選択帯､X11での一般窓飾り)｡ Places the window in a mode that takes up the entire screen, has no borders, and covers the general use area (i.e. Start menu and taskbar on Windows, dock and menubar on macOS, general window decorations on X11).

  -topmost
    これが一番手前の窓であるかを指定する(他の全ての窓の手前に表示する)｡ Specifies whether this is a topmost window (displays above all other windows).

  Windowsでは次の属性も設定できる｡ On Windows, the following attributes may be set.

  -disabled
    窓が不能の状態であるかを指定する｡ Specifies whether the window is in a disabled state.

  -toolwindow
    道具窓様式の窓を指定する( MSDN内の定義に従う)｡ Specifies a toolwindow style window (as defined in the MSDN).

  -transparentcolor
    頂上水準の透明色の指標を指定する｡ Tk_GetColor により受入れられるどの色も採りうる｡もし空文字列が指定されると(省略時設定)､どの透明色も使用できない｡これはWindows 2000/XP+ で運営されている｡運営されていない版では -transparentcolor 値は {} に留まる｡ Specifies the transparent color index of the toplevel. It takes any color value accepted by Tk_GetColor. If the empty string is specified (default), no transparent color is used. This is supported on Windows 2000/XP+. Where not supported, the -transparentcolor value remains at {}.

  macOS では次の属性も設定できる｡ On macOS, the following attributes may be set.

  -modified
    窓の修飾の状態を設定する(窓を閉じる部品が修飾指示器を含むか､代理アイコンが曳摺り可能か)｡ Specifies the modification state of the window (determines whether the window close widget contains the modification indicator and whether the proxy icon is draggable).

  -notify
    処理課程の通知状態を指定する(応用譜の接続アイコンの跳躍)｡ Specifies process notification state (bouncing of the application dock icon).

  -titlepath
    窓の代理のアイコンとして参照されるファイルの経路を指定する(そのアイコンはファイルの探索アイコンの代りに曳摺りして指定できる)｡ Specifies the path of the file referenced as the window proxy icon (which can be dragged and dropped in lieu of the file's finder icon).

  -transparent
    窓を含む領域を透明にし且つ窓の影を切断する｡透明を効果的にし､頂上水準の背景は何かのα譬えば “製造元の透明” を使って色を指定する必要がある｡ Makes the window content area transparent and turns off the window shadow. For the transparency to be effective, the toplevel background needs to be set to a color with some alpha, e.g. “systemTransparent”.

  X11では次の属性も設定できる｡これ等は全ての窓管理譜で運営されている訳ではない､古い WMs の下では効果がない｡ On X11, the following attributes may be set. These are not supported by all window managers, and will have no effect under older WMs.

  -type
    窓が指定された型になる様に窓管理譜に解釈されることを要求する｡これは､窓が異なる方法で修飾されるか､或は異なって管理されることをことを惹き起こす､但し正確に生じていることは完全に窓管理譜の範囲迄である｡型のリストは優先順位に従って使われる｡次の値は EWMH 規格内に定義された定数に対応する(それ以外も使えるが益はない): Requests that the window should be interpreted by the window manager as being of the specified type(s). This may cause the window to be decorated in a different way or otherwise managed differently, though exactly what happens is entirely up to the window manager. A list of types may be used, in order of preference. The following values are mapped to constants defined in the EWMH specification (using others is possible, but not advised):

    desktop
      机上画面の性質を指示する｡ indicates a desktop feature,

    dock
      画面の dock/panel 幾何情報を示す｡ indicates a dock/panel feature,

    toolbar
      道具類の窓であることを指し示す､ wm transient によって指示される如く､他の窓の為に活動する｡ indicates a toolbar window that should be acting on behalf of another window, as indicated with wm transient,

    menu
      引裂き指示項目聚を指し示す､ wm transient によって指示される如く､他の窓の為に活動する｡｡ indicates a torn-off menu that should be acting on behalf of another window, as indicated with wm transient,

    utility
      便益類(譬えば､色版や道具類)の窓であることを指し示す､ wm transient によって指示される如く､他の窓の為に活動する｡｡ indicates a utility window (e.g., palette or toolbox) that should be acting on behalf of another window, as indicated with wm transient,

    splash
      応用譜が開始する間表示する画面が閃くことを示す｡ indicates a splash screen, displayed during application start up,

    dialog
      一般問合せ箱の窓を指し示す､､ wm transient によって指示される如く､他の窓の為に活動する｡｡ indicates a general dialog window, that should be acting on behalf of another window, as indicated with wm transient,

    dropdown_menu
      選択帯から招き出した指示項目聚を指し示す､それは通常､向先変更上書きされている( wm overrideredirect によって)｡ indicates a menu summoned from a menu bar, which should usually also be set to be override-redirected (with wm overrideredirect),

    popup_menu
      飛出し指示項目聚を指し示す､それは通常､向先変更上書きされている( wm overrideredirect によって)｡ indicates a popup menu, which should usually also be set to be override-redirected (with wm overrideredirect),

    tooltip
      飛出し情報枠を指し示す､それは通常､向先変更上書きされている( wm overrideredirect によって)｡ indicates a tooltip window, which should usually also be set to be override-redirected (with wm overrideredirect),

    notification
      ある行事の背景処理通知を提供する窓を指し示す､それは通常､向先変更上書きされている( wm overrideredirect によって)｡ indicates a window that provides a background notification of some event, which should usually also be set to be override-redirected (with wm overrideredirect),

    combo
      combobox 部品の曳摺り重ねリストを指し示す､それは通常上書き再指定される(wm overrideredirect によって) indicates the drop-down list of a combobox widget, which should usually also be set to be override-redirected (with wm overrideredirect),

    dnd
      引張られた何かを表現する窓を指し示す､それは通常､向先変更上書きされている( wm overrideredirect によって)｡ indicates a window that represents something being dragged, which should usually also be set to be override-redirected (with wm overrideredirect),

    normal
      窓が特別な解釈実行機能を有さないことを示す｡ indicates a window that has no special interpretation.

  -zoomed
    窓が最大化されることを要求する｡これはWindows と Mac OS X の wm state zoomed と同じである｡ Requests that the window should be maximized. This is the same as wm state zoomed on Windows and macOS.

  X11 上では窓の属性は非同期で遂行される｡属性の問合せは現在の状態を返す､それは､窓管理譜が未だ処理していない場合や属性を運営していない場合は最も新しく設定した値とは異なる｡ On X11, changes to window attributes are performed asynchronously. Querying the value of an attribute returns the current state, which will not be the same as the value most recently set if the window manager has not yet processed the request or if it does not support the attribute.

wm client window ?name?
  もし name が指定されていると､命令は､窓管理譜又は期間管理譜によって使用するために name (その上で応用譜が実行されている主人の名前でなければならない)を window のWM_CLIENT_MACHINE 特性に保存する｡この命令はこの場合､空文字列を返す｡もし name が指定されていない場合､命令は最後に window に就いての wm client 命令内で設定された名前を返す｡もし name が空文字列として指定されていると､命令は window から WM_CLIENT_MACHINE 特性を削除する｡ If name is specified, this command stores name (which should be the name of the host on which the application is executing) in window's WM_CLIENT_MACHINE property for use by the window manager or session manager. The command returns an empty string in this case. If name is not specified, the command returns the last name set in a wm client command for window. If name is specified as an empty string, the command deletes the WM_CLIENT_MACHINE property from window.

wm colormapwindows window ?windowList?
  この命令は WM_COLORMAP_WINDOWS 特性の操作に使われる､それは私的な画素地図を有する窓に関する窓管理の為の情報を提供している｡ This command is used to manipulate the WM_COLORMAP_WINDOWS property, which provides information to the window managers about windows that have private colormaps.

  もし windowList が指定されていないと､この命令は WM_COLORMAP_WINDOWS 特性内の窓の名前を要素としたリストを返す｡もし windowList が指定されていると､それは､窓の経路の名前のリストで構成される; この命令は､与えられた窓のWM_COLORMAP_WINDOWS 特性によって上書きされ､空文字列が返る｡ WM_COLORMAP_WINDOWS 特性は通常､ window の内部にあり､その画素地図が親のものとは違っている内部の窓のリストを含む｡ If windowList is not specified, the command returns a list whose elements are the names of the windows in the WM_COLORMAP_WINDOWS property. If windowList is specified, it consists of a list of window path names; the command overwrites the WM_COLORMAP_WINDOWS property with the given windows and returns an empty string. The WM_COLORMAP_WINDOWS property should normally contain a list of the internal windows within window whose colormaps differ from their parents.

  特性内の窓の順序は優先順序を指し示す: 窓管理譜は window が画素地図の注目を得た時にこのリストから可能な限り多くの画素地図を実装しようと試みる｡もし､ window が windowList 内の窓に含まれていない場合､ Tk は暗黙の内に､それを WM_COLORMAP_WINDOWS 特性の末尾に追加し､結果としてその画素地図は最低の優先順位になる｡もし wm colormapwindows が起動されない場合､Tk は自動的にそれぞれの頂上水準の窓の為の特性を､その画素地図がその親とは異なっている全ての内部的な窓に設定する､次に､頂上水準そのものに設定する; 内部的窓の順序は定義されない｡ WM_COLORMAP_WINDOWS 特性に関する更なる情報は ICCCM 文書を参照されたい｡ The order of the windows in the property indicates a priority order: the window manager will attempt to install as many colormaps as possible from the head of this list when window gets the colormap focus. If window is not included among the windows in windowList, Tk implicitly adds it at the end of the WM_COLORMAP_WINDOWS property, so that its colormap is lowest in priority. If wm colormapwindows is not invoked, Tk will automatically set the property for each top-level window to all the internal windows whose colormaps differ from their parents, followed by the top-level itself; the order of the internal windows is undefined. See the ICCCM documentation for more information on the WM_COLORMAP_WINDOWS property.

wm command window ?value?
  もし value が設定された場合､この命令は､窓管理譜､又は時期管理譜に使用される為に value を window の WM_COMMAND 特性に保存し､空文字列を返す｡ value は適切な構造のリストを有さねばならない; その要素は応用譜を起動するために使われる命令の語を含まねばならない｡もし value が指定されないと命令は window の為に wm command 命令内で設定した最後の値を返す｡もし value が空文字列として指定された場合､この命令は window から WM_COMMAND 特性を削除する｡ If value is specified, this command stores value in window's WM_COMMAND property for use by the window manager or session manager and returns an empty string. Value must have proper list structure; the elements should contain the words of the command used to invoke the application. If value is not specified then the command returns the last value set in a wm command command for window. If value is specified as an empty string, the command deletes the WM_COMMAND property from window.

wm deiconify window
  window を通常形式(アイコン化されてない)で表示する様手配をする｡これは窓の対応化により遂行される｡もし窓がこの命令によって対応付けされていない場合､この命令は対応付けしないが､最初に対応付けされた時にアイコン化されない状態で現れる様に手配する｡ Windows 上ではアイコン化されない窓は前面に置かれ注目が与えられる(活性な窓にされる)｡空文字列を返す｡ Arrange for window to be displayed in normal (non-iconified) form. This is done by mapping the window. If the window has never been mapped then this command will not map the window, but it will ensure that when the window is first mapped it will be displayed in de-iconified form. On Windows, a deiconified window will also be raised and be given the focus (made the active window). Returns an empty string.

wm focusmodel window ?active|passive?
  この命令に追加的に引数として active か passive が与えられる場合､それは window の為の注目を指定する原型を指定する｡この場合､この命令は空文字列を返す｡もし追加的引数が与えられない場合､この命令は window に対する現在の注目の原型を返す｡ If active or passive is supplied as an optional argument to the command, then it specifies the focus model for window. In this case the command returns an empty string. If no additional argument is supplied, then the command returns the current focus model for window.

  active の注目の原型の意味は､ window は､たとえ､注目が現在何か他の応用譜内にあったとしても｡自己又はその子孫の為に入力の注目を請求する｡ passive の意味は､ window は自己の為には注目を請求しない: 窓管理譜は window に適切な時期に注目を与える｡しかし､一度注目が window かその子孫の内の一つに与えられると､応用譜は window の子孫の中にある注目を再度割当てるかもしれない｡注目の原型の省略時設定は passive であり､Tkの focus 命令は注目の受動的原型と仮定する｡ An active focus model means that window will claim the input focus for itself or its descendants, even at times when the focus is currently in some other application. Passive means that window will never claim the focus for itself: the window manager should give the focus to window at appropriate times. However, once the focus has been given to window or one of its descendants, the application may re-assign the focus among window's descendants. The focus model defaults to passive, and Tk's focus command assumes a passive model of focusing.

wm forget window
  window は画面から対応付けを解消され､もはや wm によって管理されなくなる｡ toplevel 命令により作成された窓は､一度､もはや wm に管理されなくなったframe窓の様に扱われるが､ -menu 構成設定が回復させ､指示項目聚が再び管理された部品を返す｡ The window will be unmapped from the screen and will no longer be managed by wm. Windows created with the toplevel command will be treated like frame windows once they are no longer managed by wm, however, the -menu configuration will be remembered and the menus will return once the widget is managed again.

wm frame window
  もし window が窓管理譜により親が変更されて修飾枠に入れられている場合､この命令は window を含む最も外側の枠のためのOS固有の窓識別子を返す(その親が原点又は仮想的原点である様な窓)｡もし window が窓管理譜により親が変更されていない場合､窓管理譜はOS固有の window の窓識別子を返す｡ If window has been reparented by the window manager into a decorative frame, the command returns the platform specific window identifier for the outermost frame that contains window (the window whose parent is the root or virtual root). If window has not been reparented by the window manager then the command returns the platform specific window identifier for window.

wm geometry window ?newGeometry?
  もし 新幾何形状 が指定された場合､ 窓 の幾何形状は変更され空文字列が返される｡それ以外の場合､現在の 窓 の幾何が返される(これは手動変形または wm geometry 命令により､最も新しく指定された幾何形状である)｡ 新幾何形状 は =widthxheight± x± y の形式を有する､ここで､ = や widthxheight や ± x± y はどれでも省略できる｡ width と height は正整数であって 窓 の望ましい寸法を指定する｡もし 窓 が格子化されていると(下の GRIDDED GEOMETRY MANAGEMENT を参照されたい)､寸法は格子単位で指定される; それ以外は画素単位で指定される｡ If newGeometry is specified, then the geometry of window is changed and an empty string is returned. Otherwise the current geometry for window is returned (this is the most recent geometry specified either by manual resizing or in a wm geometry command). NewGeometry has the form =width x height±x±y, where any of =, width x height, or ±x±y may be omitted. Width and height are positive integers specifying the desired dimensions of window. If window is gridded (see GRIDDED GEOMETRY MANAGEMENT below) then the dimensions are specified in grid units; otherwise they are specified in pixel units.

  x とy は画面上の 窓 の望ましい位置を画素単位で指定する｡もしx に + が前置されると画面の左縁と 窓 の境界の左縁との間にある画素の数を指定する｡もし - が前置されると x は画面の右縁と 窓 の境界の右縁との間の画素の数を指定する｡もしy に + が前置されると画面の上縁と 窓 の境界の上縁との間にある画素の数を指定する｡もし - が前置されるとy は画面の底縁と 窓 の境界の底縁との間の画素の数を指定する｡ X and y specify the desired location of window on the screen, in pixels. If x is preceded by +, it specifies the number of pixels between the left edge of the screen and the left edge of window's border; if preceded by - then x specifies the number of pixels between the right edge of the screen and the right edge of window's border. If y is preceded by + then it specifies the number of pixels between the top of the screen and the top of window's border; if y is preceded by - then it specifies the number of pixels between the bottom of window's border and the bottom of the screen.

  もし 新幾何形状 が空文字列として指定された場合 窓 に対するどの既存の使用者指定の幾何形状も解除されて､窓は内部的に部品に要求される寸法に復帰する｡ If newGeometry is specified as an empty string then any existing user-specified geometry for window is cancelled, and the window will revert to the size requested internally by its widgets.

  註意すべきはこれは winfo geometry に類似しているが同一ではない｡即ち後者は幾何情報の問合せができるだけだが､ window の実際の寸法と位置としての Tk の現在の認識を常に反映している､一方 wm geometry は窓の寸法と位置に関する窓管理譜の認識の設定と問合せの両方を許容する｡これにより大いに異なることがあり､譬えば､表題帯の様な窓の修飾要素の追加をもたらす為には､窓管理譜はこの命令により作成された要求に正確に従うことは要求されない｡ Note that this is related to winfo geometry, but not the same. That can only query the geometry, and always reflects Tk's current understanding of the actual size and location of window, whereas wm geometry allows both setting and querying of the window manager's understanding of the size and location of the window. This can vary significantly, for example to reflect the addition of decorative elements to window such as title bars, and window managers are not required to precisely follow the requests made through this command.

wm grid window ?baseWidth baseHeight widthInc heightInc?
  この命令は window が格子化された窓として扱われることを指し示す｡また格子単位と画素単位の関係を指定する｡ baseWidth と baseHeight は window により内部で要求される､画素寸法に対応する格子単位の数を Tk_GeometryRequest を使って､指定する｡ widthInc と heightInc はそれぞれ水平と垂直格子内の画素の数を指定する｡これ等の４つの値は､ window に受入れ可能な寸法の範囲を定め､格子基準の幅と高さに相当する非負の整数である｡ Tk はこの情報を窓管理譜に渡すことになる; 手動で変形している間､窓管理譜はこの受入可能な寸法に制限されることになる｡　　　 This command indicates that window is to be managed as a gridded window. It also specifies the relationship between grid units and pixel units. BaseWidth and baseHeight specify the number of grid units corresponding to the pixel dimensions requested internally by window using Tk_GeometryRequest. WidthInc and heightInc specify the number of pixels in each horizontal and vertical grid unit. These four values determine a range of acceptable sizes for window, corresponding to grid-based widths and heights that are non-negative integers. Tk will pass this information to the window manager; during manual resizing, the window manager will restrict the window's size to one of these acceptable sizes.

  更に､手動で変形している間､窓管理譜は画素単位でなく格子単位で現在の窓の寸法を表示する｡もし baseWidth 等が空文字列として指定される場合､ window はもはや格子化された窓としては管理されない｡もし baseWidth 等が指定される場合返る値は空文字列である｡ Furthermore, during manual resizing the window manager will display the window's current size in terms of grid units rather than pixels. If baseWidth etc. are all specified as empty strings, then window will no longer be managed as a gridded window. If baseWidth etc. are specified then the return value is an empty string.

  それ以外の場合､返る値は､現在の baseWidth と baseHeight と widthInc と heightInc の４つの要素を含む Tcl リストである; もし window が現在格子化されていない場合､空文字列が返される｡ Otherwise the return value is a Tcl list containing four elements corresponding to the current baseWidth, baseHeight, widthInc, and heightInc; if window is not currently gridded, then an empty string is returned.

  註意: この命令は頻繁には必要とされない､理由は Tk_SetGrid 外部函数と setGrid 指示項目が同じ機能を容易に利用できるように提供しているので｡ Note that this command should not be needed very often, since the Tk_SetGrid library procedure and the setGrid option provide easier access to the same functionality.

wm group window ?pathName?
  もし pathName が指定された場合､それは､関係する窓の群の主席要員の経路名である｡窓管理譜はこの情報を使い､譬えば､群の主席要員がアイコン化された時は群内の全ての窓を対応付け解除する｡ pathName は空文字列として指定されると､群のどの結合からも window が取除かれる｡もし pathName が指定された場合､命令は空文字列を返す; そうでない場合､window の現在の主席要員の名前を返すか､ window がどの群の部分でない場合は空文字列を返す｡ If pathName is specified, it gives the path name for the leader of a group of related windows. The window manager may use this information, for example, to unmap all of the windows in a group when the group's leader is iconified. PathName may be specified as an empty string to remove window from any group association. If pathName is specified then the command returns an empty string; otherwise it returns the path name of window's current group leader, or an empty string if window is not part of any group.

wm iconbitmap window ?bitmap?
  もし bitmap が指定された場合､ Tk に受入れられる標準形式の点地図を指名する(詳細は取扱説明書の Tk_GetBitmap の見出しを参照されたい)｡この点地図は window のアイコンを表示する為に窓管理譜に渡され､命令は空文字列を返す｡ bitmap として空文字列が指定されると､ window の為の､どのアイコンも解除される｡もし bitmap が指定された場合､命令は空文字列を返す｡それ以外の場合､ window に結合している現在のアイコンの名前を返すか､ window が点地図を有さない場合は空文字列を返す｡ Windows のOSでは追加的旗標が運営されている: If bitmap is specified, then it names a bitmap in the standard forms accepted by Tk (see the Tk_GetBitmap manual entry for details). This bitmap is passed to the window manager to be displayed in window's icon, and the command returns an empty string. If an empty string is specified for bitmap, then any current icon bitmap is cancelled for window. If bitmap is specified then the command returns an empty string. Otherwise it returns the name of the current icon bitmap associated with window, or an empty string if window has no icon bitmap. On the Windows operating system, an additional flag is supported:

  wm iconbitmap window ?-default? ?image?
    もし -default 旗標が与えられた場合､他のどの固有のアイコンも適用されていない全ての頂上水準の窓(既存と将来のもの)に､そのアイコンが適用される｡点地図影像型に加えて有効な window のアイコンを含むどのファイル(通常､ .ico か .icr ファイル)に対する全経路名指定も受入れられる､又は対話命令譜がアイコンを代入させたどのようなファイルも受入れられる｡Tcl は最初にファイルがアイコンを含むかを検査し､次にアイコンを割り当てさせたか､最後に､それらが失敗すると､点地図の為の検査をする｡ If the -default flag is given, the icon is applied to all toplevel windows (existing and future) to which no other specific icon has yet been applied. In addition to bitmap image types, a full path specification to any file which contains a valid Windows icon is also accepted (usually .ico or .icr files), or any file for which the shell has assigned an icon. Tcl will first test if the file contains an icon, then if it has an assigned icon, and finally, if that fails, test for a bitmap.

wm iconify window
  window のアイコン化の手配をする｡ window が最初に未だ対応付けされていない場合､対応付けされた時にアイコン化された状態で現れる様に手配する｡ Arrange for window to be iconified. It window has not yet been mapped for the first time, this command will arrange for it to appear in the iconified state when it is eventually mapped.

wm iconmask window ?bitmap?
  もし bitmap が指定された場合､ Tk に受入れられる標準形式の点地図を指名する(詳細は取扱説明書の Tk_GetBitmap の見出しを参照されたい)｡この点地図は iconbitmap 指示項目と共に篩として使われる為に窓管理譜に渡される: ここで篩が 零を有する位置ではアイコンは表示されない; 一を有する位置では､アイコン点地図の値が表示される｡ bitmap として空文字列が指定されると､ window の為の､どのアイコンの篩も解除される(これは､全て一の点地図を指定することと等価である)｡もし bitmap が指定された場合､命令は空文字列を返す｡それ以外の場合､ window に結合している現在のアイコンの篩の名前を返すか､有効な篩がない場合は空文字列を返す｡ If bitmap is specified, then it names a bitmap in the standard forms accepted by Tk (see the Tk_GetBitmap manual entry for details). This bitmap is passed to the window manager to be used as a mask in conjunction with the iconbitmap option: where the mask has zeroes no icon will be displayed; where it has ones, the bits from the icon bitmap will be displayed. If an empty string is specified for bitmap then any current icon mask is cancelled for window (this is equivalent to specifying a bitmap of all ones). If bitmap is specified then the command returns an empty string. Otherwise it returns the name of the current icon mask associated with window, or an empty string if no mask is in effect.

wm iconname window ?newName?
  もし newName が指定された場合､それは窓管理譜に渡される; 窓管理譜は newName を window に結合したアイコンの内部に表示する｡この場合､空文字列が結果として返される｡もし newName が指定されない場合､この命令は window の為の現在のアイコンの名前を返すか､アイコンの名前が指定されていない場合は空文字列を返す(この場合窓管理譜は､通常 wm title 命令によって指定された窓の表題を表示する)｡ If newName is specified, then it is passed to the window manager; the window manager should display newName inside the icon associated with window. In this case an empty string is returned as result. If newName is not specified then the command returns the current icon name for window, or an empty string if no icon name has been specified (in this case the window manager will normally display the window's title, as specified with the wm title command).

wm iconphoto window ?-default? image1 ?image2 ...?
  windowが指定されていると､これは将来作成される全ての頂上水準に同じように適用される｡影像の中のデータは起動された時の撮影であると看做される｡もし影像が後に変更された場合､これは表題帯アイコンには反映されない｡多重影像は異なる影像寸法を(譬えば､16x16 と 32x32)提供する為に許容される｡窓管理譜は与えられたアイコンを適切な寸法に縮小することもできる｡ Sets the titlebar icon for window based on the named photo images. If -default is specified, this is applied to all future created toplevels as well. The data in the images is taken as a snapshot at the time of invocation. If the images are later changed, this is not reflected to the titlebar icons. Multiple images are accepted to allow different images sizes (e.g., 16x16 and 32x32) to be provided. The window manager may scale provided icons to an appropriate size.

  Windows 上では影像はWindows のアイコン構造に梱包される｡これは指定された ico に上書きして wm iconbitmap にされ､逆転もできる｡ On Windows, the images are packed into a Windows icon structure. This will override an ico specified to wm iconbitmap, and vice versa.

  X 上では影像は _NET_WM_ICON X 特性に整えられる､これは最新の窓管理譜が運営している｡ wm iconbitmap も同時に存在している｡２つより多くのアイコンを使わないよう推奨する､最大のアイコンを先に置くこと｡ On X, the images are arranged into the _NET_WM_ICON X property, which most modern window managers support. A wm iconbitmap may exist simultaneously. It is recommended to use not more than 2 icons, placing the larger icon first.

  マッキントッシュ上では､呼出された初めの映像は OS 固有のアイコン書式内に組込まれ､伝達矩形内の応用譜アイコンと､Dock と､他の文脈になる｡記述譜水準では､命令は､マックOSがTk の有効範囲外で多重 寸法/解像度 の為に有効として假引数内に渡された最初のアイコン映像のみを受容れる｡開発者はマック上で滑らかな演出を確実にするために運営されている最大のアイコンを使うべきである(できる限り512画素を)｡　　　　　 On Macintosh, the first image called is loaded into an OS-native icon format, and becomes the application icon in dialogs, the Dock, and other contexts. At the script level the command will accept only the first image passed in the parameters as support for multiple sizes/resolutions on macOS is outside Tk's scope. Developers should use the largest icon they can support (preferably 512 pixels) to ensure smooth rendering on the Mac.

wm iconposition window ?x y?
  もし x と y が指定された場合､それは窓管理譜に window の為のアイコンが置かれた位置に就いての手掛りとして渡される｡この場合､空文字列が返される｡もし x と y が空文字列として指定された場合､どの既存のアイコンの手掛りも解消される｡もし x も y も指定されない場合､命令は現在のアイコンの位置の手掛りとなる二つの値を含む Tcl リストを返す(もし手掛りが有効でない場合空文字列が返される)｡ If x and y are specified, they are passed to the window manager as a hint about where to position the icon for window. In this case an empty string is returned. If x and y are specified as empty strings then any existing icon position hint is cancelled. If neither x nor y is specified, then the command returns a Tcl list containing two values, which are the current icon position hints (if no hints are in effect then an empty string is returned).

wm iconwindow window ?pathName?
  もし pathName が指定された場合は､それは window の為のアイコンとして使う為の窓の経路名である: window がアイコン化された時､ pathName はアイコンとして供する為に対応付けする､そして window が非アイコン化される時､再び対応付けを解除する｡もし pathName が空文字列として指定された場合､既存のどの window の為のアイコン窓も解除される｡もし pathName 引数が指定されると､空文字列が返される｡それ以外の場合､この命令は window の為の現在のアイコン窓の経路名を返すか､ window の為に現在アイコン窓が指定されていない場合は空文字列を返す｡ window の為の釦押下行事はそれがアイコン窓である限り無能である; これは､窓管理譜がこの行事を “所有” することを許容するために必要である｡註意すべきは､ 全ての窓管理譜がアイコン窓の意向を運営している訳ではない､又 非-X11のOS上ではこの概念は全く無意味である｡ If pathName is specified, it is the path name for a window to use as icon for window: when window is iconified then pathName will be mapped to serve as icon, and when window is de-iconified then pathName will be unmapped again. If pathName is specified as an empty string then any existing icon window association for window will be cancelled. If the pathName argument is specified then an empty string is returned. Otherwise the command returns the path name of the current icon window for window, or an empty string if there is no icon window currently specified for window. Button press events are disabled for window as long as it is an icon window; this is needed in order to allow window managers to “own” those events. Note that not all window managers support the notion of an icon window, and the concept is entirely meaningless on non-X11 platforms.

wm manage widget
  指定された widget が孤立した頂上水準窓になる｡この窓は窓管理表題帯等により修飾される｡ frame と labelframe と toplevel 部品のみがこの命令に使用される｡他のどのような部品の型を渡そうとする試みも不具合を起こす｡ toplevel 部品を管理する試みは､何も始まらないし何にも到達しない｡ GEOMETRY MANAGEMENT を参照されたい｡ The widget specified will become a stand alone top-level window. The window will be decorated with the window managers title bar, etc. Only frame, labelframe and toplevel widgets can be used with this command. Attempting to pass any other widget type will raise an error. Attempting to manage a toplevel widget is benign and achieves nothing. See also GEOMETRY MANAGEMENT.

wm maxsize window ?width height?
  もし width と height が指定された場合､それらは window に対する最大許容寸法を与える｡格子化された窓に対して寸法は格子単位で指定される; それ以外の場合は画素単位で指定される｡窓管理譜は窓の寸法が width と height と同じかより小さいことを強制する｡もし width と height が指定されると､命令は空文字列を返す｡それ以外の場合は､現在有効な最大の width と height の二要素の Tcl リストを返す｡最大寸法の省略時設定は画面の寸法である｡更なる情報に就いては下の幾何管理譜の節を参照されたい｡ If width and height are specified, they give the maximum permissible dimensions for window. For gridded windows the dimensions are specified in grid units; otherwise they are specified in pixel units. The window manager will restrict the window's dimensions to be less than or equal to width and height. If width and height are specified, then the command returns an empty string. Otherwise it returns a Tcl list with two elements, which are the maximum width and height currently in effect. The maximum size defaults to the size of the screen. See the sections on geometry management below for more information.

wm minsize window ?width height?
  もし width と height が指定された場合､それらは window に対する最小許容寸法を与える｡格子化された窓に対して寸法は格子単位で指定される; それ以外の場合は画素単位で指定される｡窓管理譜は窓の寸法が width と height と同じかより大きいことを強制する｡もし width と height が指定されると､命令は空文字列を返す｡それ以外の場合は､現在有効な最小の width と height の二要素の Tcl リストを返す｡最小寸法の省略時設定は縦横とも１画素である｡更なる情報に就いては下の幾何管理譜の節を参照されたい｡ If width and height are specified, they give the minimum permissible dimensions for window. For gridded windows the dimensions are specified in grid units; otherwise they are specified in pixel units. The window manager will restrict the window's dimensions to be greater than or equal to width and height. If width and height are specified, then the command returns an empty string. Otherwise it returns a Tcl list with two elements, which are the minimum width and height currently in effect. The minimum size defaults to one pixel in each dimension. See the sections on geometry management below for more information.

wm overrideredirect window ?boolean?
  boolean が適切な論理形式で指定された時は､ window の為の上書き-位置変更旗標がその値に設定される｡ boolean が指定されない時は､ window の為に上書き-位置変更旗標が設定されているか否かを指し示す 1 か 0 を返す｡ window の為に上書き-位置変更旗標を設定することは､窓管理譜にその窓を無視させることを引起す; 就中､この意味は､窓は親を換えて原点窓から修飾枠には入らない､又､使用者が通常の窓管理の仕組みを使って窓を操作することはできないことを意味する｡ If boolean is specified, it must have a proper boolean form and the override-redirect flag for window is set to that value. If boolean is not specified then 1 or 0 is returned to indicate whether or not the override-redirect flag is currently set for window. Setting the override-redirect flag for a window causes it to be ignored by the window manager; among other things, this means that the window will not be reparented from the root window into a decorative frame and the user will not be able to manipulate the window using the normal window manager mechanisms.

  註意すべきは上書き-入出力先変更旗印は､窓が最初に対応付けされた時か､通常状態への撤退から変更された後の対応付けか､の時のみ通知することを保障している､但し､全てではないがある種のOSではそれ以降も通知する｡ Note that the override-redirect flag is only guaranteed to be taken notice of when the window is first mapped or when mapped after the state is changed from withdrawn to normal. Some, but not all, platforms will take notice at additional times.

wm positionfrom window ?who?
  who が指定される場合､それは program か user か､又はその内の一つの短縮形か､でなければならない｡ window の現在の位置が､算譜か使用者に要求されてたか否かを指し示す｡多くの窓管理譜は算譜が要求した最初の位置を無視し､使用者に手動で指定する窓位置を聞く; もし user が指定されていると窓管理譜は､使用者に補助を問合せることなく､与えられた位置に窓を置く｡もし who が空文字列として指定されていると､現在の位置の源は取消される｡もし who が指定されていると､この命令は空文字列を返す｡それ以外の場合､現在の位置の源を指し示す user か window を返すか､源が未だ指定されていなければ､空文字列を返す｡大部分の窓管理譜は “源なし” は program と等価であると解釈する｡ Tk はwm geometry が起動された時､源が明示的に自動的に､位置の源を program に設定されない限り､位置の源を user に設定する｡ If who is specified, it must be either program or user, or an abbreviation of one of these two. It indicates whether window's current position was requested by the program or by the user. Many window managers ignore program-requested initial positions and ask the user to manually position the window; if user is specified then the window manager should position the window at the given place without asking the user for assistance. If who is specified as an empty string, then the current position source is cancelled. If who is specified, then the command returns an empty string. Otherwise it returns user or program to indicate the source of the window's current position, or an empty string if no source has been specified yet. Most window managers interpret “no source” as equivalent to program. Tk will automatically set the position source to user when a wm geometry command is invoked, unless the source has been set explicitly to program.

wm protocol window ?name? ?command?
  この命令は､ 窓管理通信規定の管理に使われる｡ wm protocol 命令内の name 引数は､窓管理通信規定に相当する基本子の名前である｡その実例としては WM_DELETE_WINDOW や WM_SAVE_YOURSELF や WM_TAKE_FOCUS がある｡ This command is used to manage window manager protocols. The name argument in the wm protocol command is the name of an atom corresponding to a window manager protocol. Examples include WM_DELETE_WINDOW or WM_SAVE_YOURSELF or WM_TAKE_FOCUS.

  窓管理通信規定は､窓管理譜から通常の行事処理体系の外側の Tk 応用譜に送られる伝達文の級に属す｡主な実例は WM_DELETE_WINDOW である; これ等の伝達文は､使用者が窓の表題帯内の閉鎖部品を軽叩した時に送られる｡窓管理通信規定の為の処理機能は wm protocol 命令に伴って実装される｡原則として､ wm protocol 命令に伴う通信規定の為に処理機能が実装されていない場合､その通信規定の全ての伝達文は無視される｡ WM_DELETE_WINDOW 通信規定はその規則の例外である｡起動時に､ Tk はこの通信規定の為の処理機能を実装する､それは窓の破壊によって応答する｡ wm protocol 命令は､この省略時設定の処理機能を､異なって応答するものに置換える為に使うことができる｡ A window manager protocol is a class of messages sent from a window manager to a Tk application outside of the normal event processing system. The main example is the WM_DELETE_WINDOW protocol; these messages are sent when the user clicks the close widget in the title bar of a window. Handlers for window manager protocols are installed with the wm protocol command. As a rule, if no handler has been installed for a protocol by the wm protocol command then all messages of that protocol are ignored. The WM_DELETE_WINDOW protocol is an exception to this rule. At start-up Tk installs a handler for this protocol, which responds by destroying the window. The wm protocol command can be used to replace this default handler by one which responds differently.

  利用可能な窓管理通信規定の一覧表は窓管理譜に依存する､但し､ Tk に運用されている全ての窓管理通信規定は WM_DELETE_WINDOW を提供する｡Windows の元では､使用者の終了操作や大系の再起動時に WM_SAVE_YOURSELF 伝言文が送られる｡ The list of available window manager protocols depends on the window manager, but all window managers supported by Tk provide WM_DELETE_WINDOW. On the Windows platform, a WM_SAVE_YOURSELF message is sent on user logout or system restart.

  もし name と command の両方が指定された場合､命令は name によって指定される通信規約の為の処理機能になる｡応用譜は name によって指定された通信規約の為の処理機能を有し､且つ､ command は､将来､何時であれ､窓管理譜がその通信規約の伝言文を Tk 応用譜に送る時は起動される､という事を窓管理譜に伝える為に､ name の為の基本子が窓の WM_PROTOCOLS 属性に追加されることになる｡この場合 wm protocol 命令は空文字列を返す｡もし name は指定されるが command は指定されない場合､ name の為の現在の処理機能が返される､若しくは name の為の処理機能が存在しない場合は空文字列が返される(特別な場合として､WM_DELETE_WINDOW の為の省略時設定の処理機能は返されない)｡もし command が空文字列として指定されると､ name の為の基本子は窓の WM_PROTOCOLS 通信規約から除去され､且つ､処理機能は破壊される; 空文字列が返される｡最後に､ name も command も指定されないと､ wm protocol 命令は､窓の為に現在定義されている処理機能の為の全ての通信規約の一覧表を返す｡ If both name and command are specified, then command becomes the handler for the protocol specified by name. The atom for name will be added to window's WM_PROTOCOLS property to tell the window manager that the application has a handler for the protocol specified by name, and command will be invoked in the future whenever the window manager sends a message of that protocol to the Tk application. In this case the wm protocol command returns an empty string. If name is specified but command is not, then the current handler for name is returned, or an empty string if there is no handler defined for name (as a special case, the default handler for WM_DELETE_WINDOW is not returned). If command is specified as an empty string then the atom for name is removed from the WM_PROTOCOLS property of window and the handler is destroyed; an empty string is returned. Lastly, if neither name nor command is specified, the wm protocol command returns a list of all of the protocols for which handlers are currently defined for window.

wm resizable window ?width height?
  この命令は使用者が対話的に頂上水準の窓を寸法変更できるか否かを管理する｡ width と height が指定される場合､それは､使用者によって window の幅と高さが修正されて良いかの論理値である｡この場合命令は空文字列を返す｡もし width と height が省略された場合､命令は window の幅と高さが現在変更可能かを指し示す二つの 0/1 要素のリストを返す｡省略時設定では窓は両方の方向に寸法変形可能である｡もし､寸法変更が不可の場合､窓の寸法は､最も最近の､対話的な寸法変更か､ wm geometry 命令か､に基く寸法になる｡もしそのような操作がされたことがない場合､窓の自然の寸法が使用される｡ This command controls whether or not the user may interactively resize a top-level window. If width and height are specified, they are boolean values that determine whether the width and height of window may be modified by the user. In this case the command returns an empty string. If width and height are omitted then the command returns a list with two 0/1 elements that indicate whether the width and height of window are currently resizable. By default, windows are resizable in both dimensions. If resizing is disabled, then the window's size will be the size from the most recent interactive resize or wm geometry command. If there has been no such operation then the window's natural size will be used.

wm sizefrom window ?who?
  もし who を指定する場合は program か user か､そのどちらかの短縮形かでなければならない｡それは､ window の現在の寸法が算譜か使用者に要求されていたか否かを指し示す｡ある窓管理譜では算譜に要求された寸法を無視し､使用者に窓寸法を手動で指定するよう要請する; もし user が指定されていると窓管理譜は､使用者に補助を依頼することなく､窓にその指定された寸法を与える｡もし who が空文字列として指定されていると､現在の寸法の指定者は取消される｡もし who が指定されていると､この命令は空文字列を返す｡それ以外の場合､現在の寸法の指定者を指し示す user か window を返すか､指定者が未だ指定されていなければ､空文字列を返す｡大部分の窓管理譜は “指定者なし” は program と等価であると解釈する｡ If who is specified, it must be either program or user, or an abbreviation of one of these two. It indicates whether window's current size was requested by the program or by the user. Some window managers ignore program-requested sizes and ask the user to manually size the window; if user is specified then the window manager should give the window its specified size without asking the user for assistance. If who is specified as an empty string, then the current size source is cancelled. If who is specified, then the command returns an empty string. Otherwise it returns user or window to indicate the source of the window's current size, or an empty string if no source has been specified yet. Most window managers interpret “no source” as equivalent to program.

wm stackorder window ?isabove|isbelow window?
  最低から最高の順に並べた頂上水準の窓の棚の順序のリストを返す｡一つの頂上水準の窓が渡されると､窓の子供でしかも頂上水準のもの全ての再帰的リストを返す｡現在画面に対応付けされている頂上水準のみ返す｡この stackorder 命令は､ある頂上水準が別の頂上水準の上か下に置かれているかを定める為にも使用できる｡二つの窓の引数が､ isabove か isbelow かのどちらかで区別されて送られる時の結果の論理値は､最初の窓が棚順内で現在の処､次の窓の上か下かであるか否かを指し示す｡ The stackorder command returns a list of toplevel windows in stacking order, from lowest to highest. When a single toplevel window is passed, the returned list recursively includes all of the window's children that are toplevels. Only those toplevels that are currently mapped to the screen are returned. The stackorder command can also be used to determine if one toplevel is positioned above or below a second toplevel. When two window arguments separated by either isabove or isbelow are passed, a boolean result indicates whether or not the first window is currently above or below the second window in the stacking order.

wm state window ?newstate?
  もし newstate が指定されていると､窓は新しい状態が設定される､それ以外の場合､現在の window の状態を返す: normal か iconic か withdrawn か icon か(Windows と Mac OS X のみ) zoomed のいずれか｡ iconic と icon の違いは､ iconic は(譬えば､ wm iconify 命令によって)アイコン化された窓を参照する､一方 icon は他の窓の為にアイコンとして機能する事のみを目的とする窓( wm iconwindow 命令を経由して)を参照する｡ icon 状態は設定できない｡ If newstate is specified, the window will be set to the new state, otherwise it returns the current state of window: either normal, iconic, withdrawn, icon, or (Windows and macOS only) zoomed. The difference between iconic and icon is that iconic refers to a window that has been iconified (e.g., with the wm iconify command) while icon refers to a window whose only purpose is to serve as the icon for some other window (via the wm iconwindow command). The icon state cannot be set.

wm title window ?string?
  もし､ string が指定されると､それは窓管理譜に window の為に表題として使う為に渡される(窓管理譜はこの文字列を window の表題帯内に表示する)｡この場合命令は空文字列を返す｡もし string が指定されないと命令は現在の window の表題を返す｡窓の表題の省略時設定はその名前である｡ If string is specified, then it will be passed to the window manager for use as the title for window (the window manager should display this string in window's title bar). In this case the command returns an empty string. If string is not specified then the command returns the current title for the window. The title for a window defaults to its name.

wm transient window ?container?
  もし 親分 container が指定されると窓管理譜は 窓が 親分(ここで 親分は頂上水準の窓)の為に働く一時の窓(譬えば､飛出し指示項目聚)であることを告げられる｡もし 親分が空文字列として指定されると 窓はもはや一時の窓ではないと徴付けされる｡それ以外の場合､命令は 窓の現在の 親分の経路名を返すか､もし 窓が現在一時の窓ではない場合､空文字列を返す｡一時の窓は最初に対応付けておくと親分と親分の階層状態の変更を反映する｡窓を自分自身の一時の窓にするとの試みは不具合になる｡その窓管理譜は一時の窓を違うように飾るかもしれない､通常備えている特性を取外して(譬えば､最小化､最大化釦)､しかしこれは窓管理譜の分別である｡ If container is specified, then the window manager is informed that window is a transient window (e.g. pull-down menu) working on behalf of container (where container is the path name for a top-level window). If container is specified as an empty string then window is marked as not being a transient window any more. Otherwise the command returns the path name of window's current container, or an empty string if window is not currently a transient window. A transient window will mirror state changes in the container and inherit the state of the container when initially mapped. The directed graph with an edge from each transient to its container must be acyclic. In particular, it is an error to attempt to make a window a transient of itself. The window manager may also decorate a transient window differently, removing some features normally present (e.g., minimize and maximize buttons) though this is entirely at the discretion of the window manager.

wm withdraw window
  window に就いて画面から取去られるよう手配する｡窓が対応付けを外され､又､窓管理譜の対象から外されることを惹き起す｡もし､窓が画面に対応付けされていない場合この命令は隠蔽状態への対応付けを惹き起す｡全ての窓管理譜が隠蔽状態に対応付けした窓を如何に処理するかを知っている訳ではない｡註意: 時にある窓管理譜に窓の属性の変化譬えば群別､に註意を払わせる為に窓を撤回し再度対応する(譬えば､ wm deiconify により)必要がある｡ Arranges for window to be withdrawn from the screen. This causes the window to be unmapped and forgotten about by the window manager. If the window has never been mapped, then this command causes the window to be mapped in the withdrawn state. Not all window managers appear to know how to handle windows that are mapped in the withdrawn state. Note that it sometimes seems to be necessary to withdraw a window and then re-map it (e.g. with wm deiconify) to get some window managers to pay attention to changes in window attributes such as group.

### GEOMETRY MANAGEMENT

省略時設定では頂上水準の窓は画面上に自然な寸法で現れる｡その寸法はその部品と幾何管理譜により内部的に定まる｡もし頂上水準の自然の寸法が変化すると窓の寸法はそれに一致する｡頂上水準の窓は自然の寸法以外に二つの方法で寸法が与えられる｡第１､使用者が窓管理譜の便宜､譬えば寸法変更用の取手等､を使用して手動で窓を再寸法設定できる｡第２､応用譜は wm geometry 命令を使って頂上水準の窓の寸法の為に特定の寸法を要求できる｡この二つの場合は Tk によって同じように処理される; どの場合も､要求された寸法は自然の寸法を上書きする｡空文字列の寸法を指定して wm geometry を起動することにより窓をその自然な寸法に戻す事が可能である｡ By default a top-level window appears on the screen in its natural size, which is the one determined internally by its widgets and geometry managers. If the natural size of a top-level window changes, then the window's size changes to match. A top-level window can be given a size other than its natural size in two ways. First, the user can resize the window manually using the facilities of the window manager, such as resize handles. Second, the application can request a particular size for a top-level window using the wm geometry command. These two cases are handled identically by Tk; in either case, the requested size overrides the natural size. You can return the window to its natural by invoking wm geometry with an empty geometry string.

通常､頂上水準の窓は､１画素から画面の寸法まで縦横供にどの寸法でもなり得る｡しかし､ wm minsize と wm maxsize 命令を使って許容寸法範囲を限定できる｡ wm minsize と wm maxsize 命令による範囲の設定は､手動による寸法変更や wm geometry 命令によるものと同じ様に自然な寸法を含む､全ての形式の寸法変更に適用する｡命令 wm resizable を使うことにより､縦横片方か両方の対話的寸法変更を完全にできなくすることが可能である｡ Normally a top-level window can have any size from one pixel in each dimension up to the size of its screen. However, you can use the wm minsize and wm maxsize commands to limit the range of allowable sizes. The range set by wm minsize and wm maxsize applies to all forms of resizing, including the window's natural size as well as manual resizes and the wm geometry command. You can also use the command wm resizable to completely disable interactive resizing in one or both dimensions.

wm manage と wm forget 命令は窓の結合と解除に使うことができる｡部品は wm manage 命令により処理された後､他の全ての wm 副命令は部品と供に使うことができる｡頂上水準の命令を使って作成された部品のみが､ -menu 構成設定指示項目を経由して指示項目聚を取付けられることができる｡頂上水準の部品は枠として使用でき､ wm forget 命令を使った後は､他のどの幾何管理譜によってでも管理される｡頂上水準の部品に結合したどの指示項目聚も他の管理譜により処理される時に撤回される｡その指示項目聚は､一度その窓が wm によって処理されると､再表示される｡副樹枝内の部品の為に誂えた全ての束縛で､ wm manage か wm forget 命令を経由してその頂水準の部品を変更させたものは､その束縛内のどの頂上水準の部品経路をも調整する為に再実行されなければならない｡誂えられなかった束縛は再実行する必要はない｡ The wm manage and wm forget commands may be used to perform undocking and docking of windows. After a widget is managed by wm manage command, all other wm subcommands may be used with the widget. Only widgets created using the toplevel command may have an attached menu via the -menu configure option. A toplevel widget may be used as a frame and managed with any of the other geometry managers after using the wm forget command. Any menu associated with a toplevel widget will be hidden when managed by another geometry managers. The menus will reappear once the window is managed by wm. All custom bindtags for widgets in a subtree that have their top-level widget changed via a wm manage or wm forget command, must be redone to adjust any top-level widget path in the bindtags. Bindtags that have not been customized do not have to be redone.

### GRIDDED GEOMETRY MANAGEMENT

格子の幾何管理は応用譜の部品の一つが有用な寸法を運営している時に生じる｡これは､譬えば文書校正譜内で､摺動盤､指示項目聚､その他の修飾物が寸法を固定しているが､校正譜は文書の行や行当りの文字数に幾つの数でも運営できる時に生じる｡この場合､通常は､使用者に wm geometry 命令を使ったり､対話的に窓寸法を変更したりして､行数や行当りの文字数の数値を指定させることが望ましい｡文書の場合､又､他の関係ある場合に､個別的な寸法が意味をなす､譬えば整数の行数や行当りの文字数; 恣意的な画素寸法は便利ではない｡ Gridded geometry management occurs when one of the widgets of an application supports a range of useful sizes. This occurs, for example, in a text editor where the scrollbars, menus, and other adornments are fixed in size but the edit widget can support any number of lines of text or characters per line. In this case, it is usually desirable to let the user specify the number of lines or characters-per-line, either with the wm geometry command or by interactively resizing the window. In the case of text, and in other interesting cases also, only discrete sizes of the window make sense, such as integral numbers of lines and characters-per-line; arbitrary pixel sizes are not useful.

格子の幾何管理は､この種の応用譜を運営する｡ Tk (と窓管理譜)は応用譜内にはある種の格子が存在し､応用譜は画素ではなく格子の単位により寸法変更すべきである｡格子の幾何管理は典型的には部品の為の setGrid 指示項目の使用により起動される; 又 wm grid 命令や Tk_SetGrid 呼出しでも起動される｡これらのそれぞれの手順で､特定の部品は(又は時には応用譜内の命令譜全体として)窓の為の整数の格子寸法と､画素寸法との間の関係を指定する｡非格子の幾何管理譜に帰る為には､空文字列の引数を伴った wm grid を起動する｡ Gridded geometry management provides support for this kind of application. Tk (and the window manager) assume that there is a grid of some sort within the application and that the application should be resized in terms of grid units rather than pixels. Gridded geometry management is typically invoked by turning on the setGrid option for a widget; it can also be invoked with the wm grid command or by calling Tk_SetGrid. In each of these approaches the particular widget (or sometimes code in the application as a whole) specifies the relationship between integral grid sizes for the window and pixel sizes. To return to non-gridded geometry management, invoke wm grid with empty argument strings.

格子の幾何管理譜が有効の場合､ wm minsize と wm maxsize と wm geometry 命令の中で指定した全ての寸法は画素単位ではなく格子単位として取り扱われる｡対話式の寸法変更も又､画素単位でなく格子単位の数で実行される｡ When gridded geometry management is enabled then all the dimensions specified in wm minsize, wm maxsize, and wm geometry commands are treated as grid units rather than pixel units. Interactive resizing is also carried out in even numbers of grid units rather than pixels.

### 瑕疵 BUGS

大部分の実在する窓管理譜は､ wm 命令の操作に影響する不具合を有す様に見える｡譬えば､窓が既に活動中の場合は何かの変更が効果を表さない: その窓に変更を起こすには､消去して､再表示しないといけない｡ 　　 Most existing window managers appear to have bugs that affect the operation of the wm command. For example, some changes will not take effect if the window is already active: the window will have to be withdrawn and de-iconified in order to make the change happen.

### 用例 EXAMPLES

固定寸法の窓であると告げる固定寸法の窓: 　　 A fixed-size window that says that it is fixed-size too:

    toplevel .fixed
    wm title     .fixed "Fixed-size Window"
    wm resizable .fixed 0 0

簡単な問合せ窓､画面の中心に置く: A simple dialog-like window, centred on the screen:

    # 問合せの内容を作成し整列する｡
    # Create and arrange the dialog contents.
    toplevel .msg
    label  .msg.l  -text "This is a very simple dialog demo."
    button .msg.ok -text OK -default active -command {destroy .msg}
    pack .msg.ok -side bottom -fill x
    pack .msg.l  -expand 1    -fill both

    # 真ん中の問合せ窓として部品を仕上げる｡
    # Now set the widget up as a centred dialog.

    # しかし､最初に幾何管理譜で仕上げる必要があるのは､
    # 問合せ窓の内容	として実行する必要がある
    # 完全に撤回した部品を伴う行事待ち待機…
    # But first, we need the geometry managers to finish setting
    # up the interior of the dialog, for which we need to run the
    # event loop with the widget hidden completely...
    wm withdraw .msg
    update
    set x [expr {([winfo screenwidth .] - [winfo width .msg]) / 2}]
    set y [expr {([winfo screenheight .] - [winfo height .msg]) / 2}]
    wm geometry  .msg +$x+$y
    wm transient .msg .
    wm title     .msg "Dialog demo"
    wm deiconify .msg

### SEE ALSO

toplevel, winfo

### KEYWORDS

aspect ratio, deiconify, focus model, geometry, grid, group, icon, iconify, increments, position, size, title, top-level window, units, window manager
Copyright © 1991-1994 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.