pytho****@googl*****
pytho****@googl*****
2011年 12月 23日 (金) 03:02:03 JST
8 new revisions: Revision: 4e17f10176d5 Author: cocoatomo <cocoa****@gmail*****> Date: Mon Dec 12 19:08:23 2011 Log: before identify_region http://code.google.com/p/python-doc-ja/source/detail?r=4e17f10176d5 Revision: 292359a9fe85 Author: cocoatomo <cocoa****@gmail*****> Date: Wed Dec 14 01:59:47 2011 Log: before map in styling http://code.google.com/p/python-doc-ja/source/detail?r=292359a9fe85 Revision: 57db11f5ed4d Author: cocoatomo <cocoa****@gmail*****> Date: Sun Dec 18 17:27:26 2011 Log: temp commit http://code.google.com/p/python-doc-ja/source/detail?r=57db11f5ed4d Revision: bb636db35e5d Author: cocoatomo <cocoa****@gmail*****> Date: Tue Dec 20 23:13:41 2011 Log: temp commit http://code.google.com/p/python-doc-ja/source/detail?r=bb636db35e5d Revision: 7a728af7970a Author: cocoatomo <cocoa****@gmail*****> Date: Tue Dec 20 23:15:02 2011 Log: merge http://code.google.com/p/python-doc-ja/source/detail?r=7a728af7970a Revision: 04cc2baaae63 Author: cocoatomo <cocoa****@gmail*****> Date: Thu Dec 22 09:53:06 2011 Log: library/ttk.rst translation completed http://code.google.com/p/python-doc-ja/source/detail?r=04cc2baaae63 Revision: df953f8837c6 Author: cocoatomo <cocoa****@gmail*****> Date: Thu Dec 22 09:56:03 2011 Log: merge http://code.google.com/p/python-doc-ja/source/detail?r=df953f8837c6 Revision: a3d2692258bb Author: cocoatomo <cocoa****@gmail*****> Date: Thu Dec 22 10:00:49 2011 Log: add my name into translators list http://code.google.com/p/python-doc-ja/source/detail?r=a3d2692258bb ============================================================================== Revision: 4e17f10176d5 Author: cocoatomo <cocoa****@gmail*****> Date: Mon Dec 12 19:08:23 2011 Log: before identify_region http://code.google.com/p/python-doc-ja/source/detail?r=4e17f10176d5 Modified: /library/ttk.rst ======================================= --- /library/ttk.rst Mon Dec 12 07:39:02 2011 +++ /library/ttk.rst Mon Dec 12 19:08:23 2011 @@ -302,7 +302,7 @@ | | :meth:`Misc.selection_get` を実行することで得られま す。)| +-----------------+---------------------------------------------------------+ | justify | ウィジェットの中でテキストをどう配置するかを指定しま す。| - | | "left" 、 "center" 、 "right" のうちのどれか 1 つで す。 | + | | "left", "center", "right" のうちのどれか 1 つで す。 | +-----------------+---------------------------------------------------------+ | height | ポップダウンリストの高さを行数で指定しま す。 | +-----------------+---------------------------------------------------------+ @@ -310,7 +310,7 @@ | | (:meth:`Misc.register` などで登録した) スクリプトで す。 | | | どの値を表示するかについても指定できま す。 | +-----------------+---------------------------------------------------------+ - | state | "normal" 、 "readonly" 、 "disabled" のどれか 1 つで す。| + | state | "normal", "readonly", "disabled" のどれか 1 つで す。 | | | "readonly" 状態では、直接入力値を編集することはでき ず、 | | | ユーザはドロップダウンリストから値を 1 つ選ぶことし か | | | できません。 "normal" 状態では、テキストフィールド は | @@ -407,12 +407,12 @@ +-----------+--------------------------------------------------------------+ | オプション| 説 明 | +===========+==============================================================+ - | state | "normal" 、 "disabled" 、 "hidden" のうちどれか 1 つで す。 | + | state | "normal", "disabled", "hidden" のうちどれか 1 つで す。 | | | "disabled" の場合、タブは選択することができませ ん。 | | | "hidden" の場合、タブは表示されませ ん。 | +-----------+--------------------------------------------------------------+ | sticky | ペイン領域の中に子ウィンドウがどう置かれるかを指定しま す。 | - | | 指定する値は "n" 、 "s" 、 "e" 、 "w" からなる 0 文字以上 の | + | | 指定する値は "n", "s", "e", "w" からなる 0 文字以上 の | | | 文字列です。配置マネージャの :meth:`grid` と同様 に、 | | | それぞれの文字は子ウィンドウが (北、南、東、西の) どの辺 に | | | 対して追随するかに対応していま す。 | @@ -679,7 +679,7 @@ `カラム識別子`_ を参照してください。 それぞれの要素は一意な名前で識別されます。 -要素の作成時に ID が与えられなかった場合、ウィジェットが要素の ID を生成し ます。 +要素の作成時に識別子が与えられなかった場合、ウィジェットが要素の識別子を生 成します。 このウィジェットには ``{}`` という名前の特別なルート要素があります。 ルート要素自身は表示されません; その子要素たちが階層の最上位に現れます。 @@ -719,7 +719,7 @@ +----------------+--------------------------------------------------------+ | selectmode | 組み込みのクラスバインディングが選択状態 を | | | どう管理するかを指定します。設定する値 は | - | | "extended" 、 "browse" 、 "none" のどれか 1 つで す。 | + | | "extended", "browse", "none" のどれか 1 つで す。 | | | "extended" に設定した場合 (デフォルト)、複数の要素 が | | | 選択できます。 "browse" に設定した場合、同時に 1 つ の | | | 要素しか選択できません。 "none" に設定した場合、選択 を | @@ -919,49 +919,49 @@ .. method:: heading(column[, option=None[, **kw]]) - Query or modify the heading options for the specified *column*. - - If *kw* is not given, returns a dict of the heading option values. If - *option* is specified then the value for that *option* is returned. - Otherwise, sets the options to the corresponding values. - - The valid options/values are: - - * text: text - The text to display in the column heading. - * image: imageName - Specifies an image to display to the right of the column heading. + 指定された *column* の heading のオプションを問い合わせたり、変更した りします。 + + *kw* が与えられなかった場合は、見出しのオプション値の辞書が返されま す。 + *option* が指定されている場合は、 *option* の値が返されます。 + それ以外の場合は、オプションに値を設定します。 + + 設定できるオプションとその値は次の通りです: + + * text: テキスト + カラムの見出しに表示するテキスト。 + * image: 画像名 + カラムの見出しの右に表示する画像を指定します。 * anchor: anchor - Specifies how the heading text should be aligned. One of the standard - Tk anchor values. - * command: callback - A callback to be invoked when the heading label is pressed. - - To configure the tree column heading, call this with column = "#0". - + 見出しのテキストをどう配置するかを指定します。標準の Tk anchor の 値です。 + * command: コールバック + 見出しラベルがクリックされたときに実行されるコールバックです。 + + ツリーカラムの見出しの設定を行うには、 column = "#0" を付けてこのメソ ッドを呼び出してください。 .. method:: identify(component, x, y) - Returns a description of the specified *component* under the point given - by *x* and *y*, or the empty string if no such *component* is present at - that position. + *x* *y* で与えられた場所にある指定された *component* の説明を返しま す。 + その場所に指定された *component* が無い場合は空文字列を返します。 + (訳注: component には "region", "item", "column", "row", "element" が 指定でき、 + それぞれ "cell", "heading" などの場所の名前、要素の識別子、 #n という 形式のカラム名、 + その行にある要素の識別子、 "text", "padding" などの画面構成要素の名前 を返します。) .. method:: identify_row(y) - Returns the item ID of the item at position *y*. + y 座標が *y* の位置にある要素の識別子を返します。 .. method:: identify_column(x) - Returns the data column identifier of the cell at position *x*. - - The tree column has ID #0. + x 座標が *x* の位置にあるセルのデータカラムの識別子を返します。 + + ツリーカラムは #0 という識別子を持ちます。 .. method:: identify_region(x, y) - Returns one of: + 以下のうち 1 つを返します: +-----------+--------------------------------------+ | region | meaning | ============================================================================== Revision: 292359a9fe85 Author: cocoatomo <cocoa****@gmail*****> Date: Wed Dec 14 01:59:47 2011 Log: before map in styling http://code.google.com/p/python-doc-ja/source/detail?r=292359a9fe85 Modified: /library/ttk.rst ======================================= --- /library/ttk.rst Mon Dec 12 19:08:23 2011 +++ /library/ttk.rst Wed Dec 14 01:59:47 2011 @@ -964,169 +964,162 @@ 以下のうち 1 つを返します: +-----------+--------------------------------------+ - | region | meaning | + | region | 意味 | +===========+======================================+ - | heading | Tree heading area. | + | heading | ツリーの見出し領域 | +-----------+--------------------------------------+ - | separator | Space between two columns headings. | + | separator | 2 つのカラム見出しの間のスペース | +-----------+--------------------------------------+ - | tree | The tree area. | + | tree | ツリーの領域 | +-----------+--------------------------------------+ - | cell | A data cell. | + | cell | データセル | +-----------+--------------------------------------+ - Availability: Tk 8.6. + 使用可能バージョン: Tk 8.6 .. method:: identify_element(x, y) - Returns the element at position *x*, *y*. - - Availability: Tk 8.6. + *x* *y* の位置にある画面構成要素の名前を返します。 + + 使用可能バージョン: Tk 8.6 .. method:: index(item) - Returns the integer index of *item* within its parent's list of children. + 親要素の子要素リストの中での *item* のインデックスを返します。 .. method:: insert(parent, index[, iid=None[, **kw]]) - Creates a new item and returns the item identifier of the newly created - item. - - *parent* is the item ID of the parent item, or the empty string to create - a new top-level item. *index* is an integer, or the value "end", - specifying where in the list of parent's children to insert the new item. - If *index* is less than or equal to zero, the new node is inserted at - the beginning; if *index* is greater than or equal to the current number - of children, it is inserted at the end. If *iid* is specified, it is used - as the item identifier; *iid* must not already exist in the tree. - Otherwise, a new unique identifier is generated. - - See `要素オプション`_ for the list of available points. + 新しい要素を作り、その要素の識別子を返します。 + + *parent* は親となる要素の識別子で、空文字列にすると新しい + 要素を最上位に作成します。 + *index* は整数もしくは "end" という値で、それによって + 親要素の子要素リストのどこに新しい要素を挿入するかを指定します。 + *index* が 0 以下だった場合は、新しい要素は先頭に挿入されます; + *index* が現在の子要素の数以上だった場合は末尾に挿入されます。 + *iid* が指定された場合は、要素の識別子として使われます; + *iid* はまだツリーに存在していないものに限ります。 + それ以外の場合は、一意な識別子が生成されます。 + + 使用できるオプションのリストについては `要素オプション`_ を参照してく ださい。 .. method:: item(item[, option[, **kw]]) - Query or modify the options for the specified *item*. - - If no options are given, a dict with options/values for the item is - returned. - If *option* is specified then the value for that option is returned. - Otherwise, sets the options to the corresponding values as given by *kw*. + 指定された *item* のオプションを問い合わせたり、変更したりします。 + + オプションが与えられなかった場合は、要素のオプションと値が辞書の形で 返されます。 + *option* が指定された場合は、そのオプションの値が返されます。 + それ以外の場合は、 *kw* で与えられたようにオプションに値が設定されま す。 .. method:: move(item, parent, index) - Moves *item* to position *index* in *parent*'s list of children. - - It is illegal to move an item under one of its descendants. If *index* is - less than or equal to zero, *item* is moved to the beginning; if greater - than or equal to the number of children, it is moved to the end. If *item* - was detached it is reattached. + *item* を *parent* の子要素リストの *index* の位置に移動します。 + + 要素を自身の子孫の下に移動させるのは許されていません。 + *index* が 0 以下の場合、 *item* は先頭に移動されます; + 子要素の数以上だった場合、末尾に移動されます。 + *item* が切り離された状態の場合は、再度取り付けられます。 .. method:: next(item) - Returns the identifier of *item*'s next sibling, or '' if *item* is the - last child of its parent. + *item* の 1 つ下の兄弟の識別子を、 *item* が親にとって一番下の子供だ った場合 '' を返します。 .. method:: parent(item) - Returns the ID of the parent of *item*, or '' if *item* is at the top - level of the hierarchy. + *item* の親の識別子を、 *item* が階層の最上位にいた場合 '' を返しま す。 .. method:: prev(item) - Returns the identifier of *item*'s previous sibling, or '' if *item* is - the first child of its parent. + *item* の 1 つ上の兄弟の識別子を、 *item* が親にとって一番上の子供だ った場合 '' を返します。 .. method:: reattach(item, parent, index) - An alias for :meth:`Treeview.move`. + :meth:`Treeview.move` のエイリアスです。 .. method:: see(item) - Ensure that *item* is visible. - - Sets all of *item*'s ancestors open option to True, and scrolls the - widget if necessary so that *item* is within the visible portion of - the tree. + *item* を見える状態にします。 + + *item* の全ての子孫の open オプションを True にし、必要であれば *item* がツリーの見える範囲に来るようにウィジェットをスクロールさせます。 .. method:: selection([selop=None[, items=None]]) - If *selop* is not specified, returns selected items. Otherwise, it will - act according to the following selection methods. + *selop* が指定されなかった場合は、選択されている要素を返します。 + そうでなければ、以下の選択メソッドに従って動作します。 + (訳注: *selop* には "set", "add", "remove", "toggle" のうち 1 つが指 定できます。 + *items* にはそれぞれのメソッドの引数を指定します。) .. method:: selection_set(items) - *items* becomes the new selection. + 新しく選択状態の要素が *items* になります。 .. method:: selection_add(items) - Add *items* to the selection. + 選択状態の要素として *items* を追加します。 .. method:: selection_remove(items) - Remove *items* from the selection. + 選択状態の要素から *items* を取り除きます。 .. method:: selection_toggle(items) - Toggle the selection state of each item in *items*. + *items* のそれぞれの要素の選択状態を入れ替えます。 .. method:: set(item[, column=None[, value=None]]) - With one argument, returns a dictionary of column/value pairs for the - specified *item*. With two arguments, returns the current value of the - specified *column*. With three arguments, sets the value of given - *column* in given *item* to the specified *value*. + 1 引数で呼び出された場合、指定された *item* のカラムと値のペアからな る辞書を返します。 + 2 引数で呼び出された場合、指定された *column* の現在の値を返します。 + 3 引数で呼び出された場合、与えられた *item* の *column* を指定された 値 *value* に設定します。 .. method:: tag_bind(tagname[, sequence=None[, callback=None]]) - Bind a callback for the given event *sequence* to the tag *tagname*. - When an event is delivered to an item, the callbacks for each of the - item's tags option are called. + 与えられたイベント *sequence* 用のコールバックをタグ *tagname* にバイ ンドします。 + イベントが要素に渡ってきたときに、要素の tags オプションのそれぞれの コールバックが呼び出されます。 .. method:: tag_configure(tagname[, option=None[, **kw]]) - Query or modify the options for the specified *tagname*. - - If *kw* is not given, returns a dict of the option settings for - *tagname*. If *option* is specified, returns the value for that *option* - for the specified *tagname*. Otherwise, sets the options to the - corresponding values for the given *tagname*. + 指定された *tagname* のオプションを問い合わせたり、変更したりします。 + + *kw* が与えられなかった場合、 *tagname* のオプション設定を辞書の形で 返します。 + *option* が指定された場合、指定された *tagname* の *option* の値を返 します。 + それ以外の場合、与えられた *tagname* のオプションに値を設定します。 .. method:: tag_has(tagname[, item]) - If *item* is specified, returns 1 or 0 depending on whether the specified - *item* has the given *tagname*. Otherwise, returns a list of all items - that have the specified tag. - - Availability: Tk 8.6 + *item* が指定されていた場合、指定された *item* が与えられた *tagname* を + 持っているかどうかに従って 1 または 0 が返されます。 + そうでない場合、指定されたタグを持つ全ての要素のリストを返します。 + + 使用可能バージョン: Tk 8.6 .. method:: xview(*args) - Query or modify horizontal position of the treeview. + ツリービューの水平方向の位置を問い合わせたり、変更したりします。 .. method:: yview(*args) - Query or modify vertical position of the treeview. + ツリービューの垂直方向の位置を問い合わせたり、変更したりします。 .. _TtkStyling: @@ -1134,33 +1127,34 @@ Ttk Styling ----------- -Each widget in :mod:`ttk` is assigned a style, which specifies the set of -elements making up the widget and how they are arranged, along with dynamic and -default settings for element options. By default the style name is the same as -the widget's class name, but it may be overridden by the widget's style -option. If the class name of a widget is unknown, use the method -:meth:`Misc.winfo_class` (somewidget.winfo_class()). +:mod:`ttk` のそれぞれのウィジェットにはスタイルが関連付けられていて、 +それと動的もしくはデフォルトで設定される要素のオプションによって +ウィジェットを構成する要素とその配置を指定します。 +デフォルトではスタイル名はウィジェットのクラス名と同じですが、ウィジェット の style オプションで上書きすることができます。 +ウィジェットのクラス名が分からない場合は、 :meth:`Misc.winfo_class` (somewidget.winfo_class()) メソッドを使ってください。 .. seealso:: `Tcl'2004 conference presentation <http://tktable.sourceforge.net/tile/tile-tcl2004.pdf>`_ - This document explains how the theme engine works + この文書ではテーマエンジンがどう動くかを説明しています .. class:: Style - This class is used to manipulate the style database. + このクラスはスタイルデータベースを操作するために使われます。 .. method:: configure(style, query_opt=None, **kw) - Query or set the default value of the specified option(s) in *style*. - - Each key in *kw* is an option and each value is a string identifying - the value for that option. + *style* の指定されたオプションのデフォルト値を問い合わせたり、設定し たりします。 + + *kw* のそれぞれのキーはオプションで値はそのオプションの値の文字列で す。 For example, to change every default button to be a flat button with some padding and a different background color do:: + 例えば、全てのデフォルトのボタンをパディングのある平らな見た目にし + 背景の色を変更するには以下のようにします + :: import ttk import Tkinter ============================================================================== Revision: 57db11f5ed4d Author: cocoatomo <cocoa****@gmail*****> Date: Sun Dec 18 17:27:26 2011 Log: temp commit http://code.google.com/p/python-doc-ja/source/detail?r=57db11f5ed4d Modified: /library/ttk.rst ======================================= --- /library/ttk.rst Wed Dec 14 01:59:47 2011 +++ /library/ttk.rst Sun Dec 18 17:27:26 2011 @@ -36,10 +36,10 @@ from Tkinter import * from ttk import * -このように書くと、いくつかの :mod:`ttk` ウィジェット (:class:`Button` 、 -:class:`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:`Label` 、 -:class:`LabelFrame`, :class:`Menubutton`, :class:`PanedWindow` 、 -:class:`Radiobutton`, :class:`Scale` 、 +このように書くと、いくつかの :mod:`ttk` ウィジェット (:class:`Button`, +:class:`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:`Label`, +:class:`LabelFrame`, :class:`Menubutton`, :class:`PanedWindow`, +:class:`Radiobutton`, :class:`Scale`, :class:`Scrollbar`) は自動的に Tk ウィジェットを置き換えます。 これにはプラットフォームをまたいでより良い見た目を得られるという、直接的な 利益がありますが、ウィジェットは完全な互換性を持っているわけではないことに注 意してください。 @@ -56,12 +56,12 @@ ---------------- Ttk には 17 のウィジェットがあり、そのうち 11 は Tkinter に既にあるもので す: -:class:`Button`, :class:`Checkbutton`, :class:`Entry`, :class:`Frame` 、 -:class:`Label`, :class:`LabelFrame`, :class:`Menubutton` 、 -:class:`PanedWindow`, :class:`Radiobutton`, :class:`Scale` 、 +:class:`Button`, :class:`Checkbutton`, :class:`Entry`, :class:`Frame`, +:class:`Label`, :class:`LabelFrame`, :class:`Menubutton`, +:class:`PanedWindow`, :class:`Radiobutton`, :class:`Scale`, :class:`Scrollbar` 。 -新しい 6 つのウィジェットクラスは次のものです: :class:`Combobox` 、 -:class:`Notebook`, :class:`Progressbar`, :class:`Separator` 、 +新しい 6 つのウィジェットクラスは次のものです: :class:`Combobox`, +:class:`Notebook`, :class:`Progressbar`, :class:`Separator`, :class:`Sizegrip`, :class:`Treeview` 。 これらのクラスは全て :class:`Widget` の子クラスです。 @@ -74,7 +74,8 @@ l2 = Tkinter.Label(text="Test", fg="black", bg="white") -それに相当する Ttk のコード:: +それに相当する Ttk のコード +:: style = ttk.Style() style.configure("BW.TLabel", foreground="black", background="white") @@ -281,11 +282,11 @@ :class:`ttk.Combobox` ウィジェットはテキストフィールドと値のポップダウンリ ストを結び付けます。 このウィジェットは :class:`Entry` の子クラスです。 -:class:`Widget` から継承したメソッド (:meth:`Widget.cget`、 -:meth:`Widget.configure`, :meth:`Widget.identify`, :meth:`Widget.instate` -、 :meth:`Widget.state`) と :class:`Entry` から継承したメソッド -(:meth:`Entry.bbox`, :meth:`Entry.delete`, :meth:`Entry.icursor` 、 -:meth:`Entry.index`, :meth:`Entry.inset`, :meth:`Entry.selection` 、 +:class:`Widget` から継承したメソッド (:meth:`Widget.cget`, +:meth:`Widget.configure`, :meth:`Widget.identify`, :meth:`Widget.instate`, +:meth:`Widget.state`) と :class:`Entry` から継承したメソッド +(:meth:`Entry.bbox`, :meth:`Entry.delete`, :meth:`Entry.icursor`, +:meth:`Entry.index`, :meth:`Entry.inset`, :meth:`Entry.selection`, :meth:`Entry.xview`) に加え、このクラスには :class:`ttk.Combobox` で説明す る メソッドがあります。 @@ -1148,12 +1149,11 @@ *style* の指定されたオプションのデフォルト値を問い合わせたり、設定し たりします。 - *kw* のそれぞれのキーはオプションで値はそのオプションの値の文字列で す。 - - For example, to change every default button to be a flat button with some - padding and a different background color do:: + *kw* のそれぞれのキーはオプション名で値はそのオプションの値の文字列で す。 + 例えば、全てのデフォルトのボタンをパディングのある平らな見た目にし 背景の色を変更するには以下のようにします + :: import ttk @@ -1172,14 +1172,15 @@ .. method:: map(style, query_opt=None, **kw) - Query or sets dynamic values of the specified option(s) in *style*. - - Each key in *kw* is an option and each value should be a list or a - tuple (usually) containing statespecs grouped in tuples, lists, or - something else of your preference. A statespec is a compound of one - or more states and then a value. - - An example:: + *style* の指定されたオプションの動的な値を問い合わせたり、設定したり します。 + + *kw* のそれぞれのキーはオプション名で、値はタプルやリストや + 何か他の好きなものでグループ化された状態仕様 (statespec) を要素とする リストやタプルです。 + 状態仕様は 1 つもしくは複数の状態と値の組み合わせです。 + + 例 + + :: import Tkinter import ttk @@ -1196,12 +1197,16 @@ root.mainloop() - +*** something wrong in this code. cannot find style 'C.Button'. verify implementationn Note that the order of the (states, value) sequences for an option matters. In the previous example, if you change the order to ``[('active', 'blue'), ('pressed', 'red')]`` in the foreground option, for example, you would get a blue foreground when the widget is in the active or pressed states. + あるオプションに対する状態と値の組 (states, value) の並び順は + スタイルに影響を与えることに注意してください。 + 例えば、 foreground オプションの順序を ``[('active', 'blue'), ('pressed', 'red')]`` に変更した場合、 + ウィジェットがアクティブなとき*** .. method:: lookup(style, option[, state=None[, default=None]]) ============================================================================== Revision: bb636db35e5d Author: cocoatomo <cocoa****@gmail*****> Date: Tue Dec 20 23:13:41 2011 Log: temp commit http://code.google.com/p/python-doc-ja/source/detail?r=bb636db35e5d Modified: /library/ttk.rst ======================================= --- /library/ttk.rst Sun Dec 18 17:27:26 2011 +++ /library/ttk.rst Tue Dec 20 23:13:41 2011 @@ -1197,26 +1197,23 @@ root.mainloop() -*** something wrong in this code. cannot find style 'C.Button'. verify implementationn - Note that the order of the (states, value) sequences for an - option matters. In the previous example, if you change the - order to ``[('active', 'blue'), ('pressed', 'red')]`` in the - foreground option, for example, you would get a blue foreground - when the widget is in the active or pressed states. + あるオプションに対する状態と値の組 (states, value) の並び順は スタイルに影響を与えることに注意してください。 例えば、 foreground オプションの順序を ``[('active', 'blue'), ('pressed', 'red')]`` に変更した場合、 - ウィジェットがアクティブなとき*** + ウィジェットがアクティブもしくは押された状態のとき前面が青くなりま す。 + .. method:: lookup(style, option[, state=None[, default=None]]) - Returns the value specified for *option* in *style*. - - If *state* is specified, it is expected to be a sequence of one or more - states. If the *default* argument is set, it is used as a fallback value - in case no specification for option is found. - - To check what font a Button uses by default, do:: + *style* の指定された *option* の値を返します。 + + *state* を指定する場合は、1 つ以上の状態名の並びである必要がありま す。 + *default* 引数が指定されていた場合は、オプション指定が見付からなかっ たときに + 代わりに返される値として使われます。 + + デフォルトでボタンがどのフォントを使うかを調べるには、以下のように実 行します + :: import ttk @@ -1225,16 +1222,18 @@ .. method:: layout(style[, layoutspec=None]) - Define the widget layout for given *style*. If *layoutspec* is omitted, - return the layout specification for given style. - - *layoutspec*, if specified, is expected to be a list or some other - sequence type (excluding strings), where each item should be a tuple and - the first item is the layout name and the second item should have the - format described described in `Layouts`_. - - To understand the format, see the following example (it is not - intended to do anything useful):: + 与えられた *style* でのウィジェットのレイアウトを定義します。 + *layoutspec* が省略されていた場合は、 + 与えられたスタイルのレイアウト仕様を返します。 + + *layoutspec* を指定する場合は、リストもしくは + (文字列を除いた) 他のシーケンス型である必要があります。 + それぞれの要素はタプルで、レイアウト名を 1 番目の要素とし、 + 2 番目の要素は `レイアウト`_ で説明されているフォーマットである必要が あります。 + + フォーマットを理解するために以下の例を見てください + (何かを使い易くするための例ではありません) + :: import ttk import Tkinter @@ -1260,74 +1259,72 @@ .. method:: element_create(elementname, etype, *args, **kw) - Create a new element in the current theme, of the given *etype* which is - expected to be either "image", "from" or "vsapi". The latter is only - available in Tk 8.6a for Windows XP and Vista and is not described here. - - If "image" is used, *args* should contain the default image name followed - by statespec/value pairs (this is the imagespec), and *kw* may have the - following options: + 与えられた *etype* ("image", "from", "vsapi" のいずれか) の現在のテー マに新しい要素を作成します。 + 最後の "vsapi" は Windows XP と Vista の Tk 8.6a のみで使用可能でここ では説明しません。 + + "image" が使われた場合、 *args* はデフォルトの画像名の後ろに + 状態仕様と値のペア (これが画像仕様です) を並べたものである必要があり ます。 + *kw* には以下のオプションが指定できます: * border=padding - padding is a list of up to four integers, specifying the left, top, - right, and bottom borders, respectively. + padding は 4 個以下の整数のリストで、それぞれ左、上、右、下の縁の 幅を指定します。 * height=height - Specifies a minimum height for the element. If less than zero, the - base image's height is used as a default. + 要素の最小の高さを指定します。0 より小さい場合は、 + 画像の高さをデフォルトとして使用します。 * padding=padding - Specifies the element's interior padding. Defaults to border's value - if not specified. + 要素の内部のパディングを指定します。指定されない場合は、 + border の値がデフォルトとして使われます。 * sticky=spec Specifies how the image is placed within the final parcel. spec contains zero or more characters “n”, “s”, “w”, or “e”. + 1 つ外側の枠に対し画像をどう配置するかを指定します。 + spec は "n", "s", "w", "e" の文字を 0 個以上含みます。 * width=width - Specifies a minimum width for the element. If less than zero, the - base image's width is used as a default. - - If "from" is used as the value of *etype*, - :meth:`element_create` will clone an existing - element. *args* is expected to contain a themename, from which - the element will be cloned, and optionally an element to clone from. - If this element to clone from is not specified, an empty element will - be used. *kw* is discarded. + 要素の最小の幅を指定します。0 より小さい場合は、 + 画像の幅をデフォルトとして使用します。 + + *etype* の値として "from" が使われた場合は、 + :meth:`element_create` が現在の要素を複製します。 + *args* は要素の複製元のテーマの名前と、オプションで複製する要素を含ん でいる必要があります。 + 複製元の要素が指定されていなかった場合、空要素が使用され、 *kw* は破 棄されます。 .. method:: element_names() - Returns the list of elements defined in the current theme. + 現在のテーマに定義されている要素のリストを返します。 .. method:: element_options(elementname) - Returns the list of *elementname*'s options. + *elementname* のオプションのリストを返します。 .. method:: theme_create(themename[, parent=None[, settings=None]]) - Create a new theme. - - It is an error if *themename* already exists. If *parent* is specified, - the new theme will inherit styles, elements and layouts from the parent - theme. If *settings* are present they are expected to have the same - syntax used for :meth:`theme_settings`. + 新しいテーマを作成します。 + + *themename* が既に存在していた場合はエラーになります。 + *parent* が指定されていた場合は、新しいテーマは親テーマからスタイルや 要素やレイアウトを継承します。 + *settings* が指定された場合は、 :meth:`theme_settings` で使われるのと + 同じ形式である必要があります。 .. method:: theme_settings(themename, settings) - Temporarily sets the current theme to *themename*, apply specified - *settings* and then restore the previous theme. - - Each key in *settings* is a style and each value may contain the keys - 'configure', 'map', 'layout' and 'element create' and they are expected - to have the same format as specified by the methods - :meth:`Style.configure`, :meth:`Style.map`, :meth:`Style.layout` and - :meth:`Style.element_create` respectively. - - As an example, let's change the Combobox for the default theme a bit:: + 一時的に現在のテーマを *themename* に設定し、指定された *settings* を 適用した後、元のテーマを復元します。 + + *settings* のそれぞれのキーはスタイル名で値はさらに + 'configure', 'map', 'layout', 'element create' をキーとして持ち、 + その値はそれぞれ :meth:`Style.configure`, :meth:`Style.map`, + :meth:`Style.layout`, :meth:`Style.element_create` メソッドで + 指定するのと同じ形式である必要があります。 + + 例として、コンボボックスの default テーマを少し変更してみましょう + :: import ttk import Tkinter @@ -1355,24 +1352,25 @@ .. method:: theme_names() - Returns a list of all known themes. + 全ての既存のテーマのリストを返します。 .. method:: theme_use([themename]) - If *themename* is not given, returns the theme in use. Otherwise, sets - the current theme to *themename*, refreshes all widgets and emits a - <<ThemeChanged>> event. + *themename* が与えられなかった場合は、現在使用中のテーマ名を返しま す。 + そうでない場合は、現在のテーマを *themename* に設定し、 + 全てのウィジェットを再描画し、 <<ThemeChanged>> イベントを発生させま す。 -Layouts -^^^^^^^ +レイアウト +^^^^^^^^^^ A layout can be just None, if it takes no options, or a dict of options specifying how to arrange the element. The layout mechanism uses a simplified version of the pack geometry manager: given an initial cavity, each element is allocated a parcel. Valid options/values are: +レイアウトはオプションを取らない場合はただの None にでき、 * side: whichside Specifies which side of the cavity to place the element; one of @@ -1392,4 +1390,4 @@ element is a tuple (or other sequence type) where the first item is the layout name, and the other is a `Layout`_. -.. _Layout: `Layouts`_ +.. _Layout: `レイアウト`_ ============================================================================== Revision: 7a728af7970a Author: cocoatomo <cocoa****@gmail*****> Date: Tue Dec 20 23:15:02 2011 Log: merge http://code.google.com/p/python-doc-ja/source/detail?r=7a728af7970a ============================================================================== Revision: 04cc2baaae63 Author: cocoatomo <cocoa****@gmail*****> Date: Thu Dec 22 09:53:06 2011 Log: library/ttk.rst translation completed http://code.google.com/p/python-doc-ja/source/detail?r=04cc2baaae63 Modified: /library/ttk.rst ======================================= --- /library/ttk.rst Tue Dec 20 23:13:41 2011 +++ /library/ttk.rst Thu Dec 22 09:53:06 2011 @@ -17,7 +17,7 @@ .. seealso:: `Tk Widget Styling Support <http://www.tcl.tk/cgi-bin/tct/tip/48>`_ - Tk のテーマサポートの始まりのドキュメント + Tk のテーマサポートの立ち上げのドキュメント Ttk を使う @@ -27,11 +27,13 @@ import ttk -しかしこのようなコードでは:: +しかしこのようなコードでは +:: from Tkinter import * -このように使いたいことがあるかもしれません:: +このように使いたいことがあるかもしれません +:: from Tkinter import * from ttk import * @@ -68,7 +70,8 @@ 上にも書いた通り、スタイルの記述コードと同様に見た目も変わっていることに気 付くでしょう。 それを見せるために、非常に簡単な例を以下に示します。 -Tk のコード:: +Tk のコード +:: l1 = Tkinter.Label(text="Test", fg="black", bg="white") l2 = Tkinter.Label(text="Test", fg="black", bg="white") @@ -396,13 +399,6 @@ タブオプション ^^^^^^^^^^^^^^ -.. memo - - by cocoatomo - The description about image option refers to :class:`Widget`, - which section has no explanation about image option. - It may be refering `ラベルオプション`_ ? - タブ用のオプションもあります: +-----------+--------------------------------------------------------------+ @@ -425,7 +421,7 @@ | text | タブに表示するテキストを指定しま す。 | +-----------+--------------------------------------------------------------+ | image | タブに表示する画像を指定します。 :class:`Widget` の | - | | オプションの説明を参照してくださ い。 | + | | `ラベルオプション`_ の説明を参照してくださ い。 | +-----------+--------------------------------------------------------------+ | compound | text オプションと image オプションが両方指定されているとき に | | | テキストに対して画像をどう表示するかを指定しま す。 | @@ -699,6 +695,7 @@ - tag binding refers tag_bind method - 'list' is list in Tcl, which is space-separated strings, not list in Python + TODO add explanation for list in Tcl .. tabularcolumns:: |p{0.2\textwidth}|p{0.7\textwidth}| .. @@ -727,7 +724,7 @@ | | 変更することはできませ ん。 | | | | | | このオプションの値によらず、アプリケーションのコード と | - | | タグバインディングからは好きなように選択状態 を | + | | 関連付けられているタグからは好きなように選択状態 を | | | 設定できま す。 | +----------------+--------------------------------------------------------+ | show | ツリーのどの要素を表示するかを指定する、以下にある値 を | @@ -1125,8 +1122,8 @@ .. _TtkStyling: -Ttk Styling ------------ +Ttk スタイル +------------ :mod:`ttk` のそれぞれのウィジェットにはスタイルが関連付けられていて、 それと動的もしくはデフォルトで設定される要素のオプションによって @@ -1227,7 +1224,7 @@ 与えられたスタイルのレイアウト仕様を返します。 *layoutspec* を指定する場合は、リストもしくは - (文字列を除いた) 他のシーケンス型である必要があります。 + (文字列を除いた) 何か他のシーケンス型である必要があります。 それぞれの要素はタプルで、レイアウト名を 1 番目の要素とし、 2 番目の要素は `レイアウト`_ で説明されているフォーマットである必要が あります。 @@ -1278,8 +1275,6 @@ border の値がデフォルトとして使われます。 * sticky=spec - Specifies how the image is placed within the final parcel. spec - contains zero or more characters “n”, “s”, “w”, or “e”. 1 つ外側の枠に対し画像をどう配置するかを指定します。 spec は "n", "s", "w", "e" の文字を 0 個以上含みます。 @@ -1365,29 +1360,29 @@ レイアウト ^^^^^^^^^^ -A layout can be just None, if it takes no options, or a dict of -options specifying how to arrange the element. The layout mechanism -uses a simplified version of the pack geometry manager: given an -initial cavity, each element is allocated a parcel. Valid -options/values are: -レイアウトはオプションを取らない場合はただの None にでき、 - - * side: whichside - Specifies which side of the cavity to place the element; one of - top, right, bottom or left. If omitted, the element occupies the - entire cavity. - - * sticky: nswe - Specifies where the element is placed inside its allocated parcel. - - * unit: 0 or 1 +レイアウトはオプションを取らない場合はただの None にできますし、 +そうでない場合は要素をどう配置するかを指定するオプションの辞書になります。 +レイアウト機構は単純化したジオメトリマネージャを使っています: +最初に空間が与えられ、それぞれの要素に分割された空間が配分されます。 +設定できるオプションと値は次の通りです: + + * side: 辺の名前 + 要素を空間のどちら側に配置するかを指定します; + top, right, bottom, left のどれか 1 つです。 + 省略された場合は、要素は空間全体を占めます。 + + * sticky: n, s, w, e から 0 個以上 + 配分された空間の内部に要素をどう配置するかを指定します。 + + * unit: 0 か 1 If set to 1, causes the element and all of its descendants to be treated as a single element for the purposes of :meth:`Widget.identify` et al. It's used for things like scrollbar thumbs with grips. - - * children: [sublayout... ] - Specifies a list of elements to place inside the element. Each - element is a tuple (or other sequence type) where the first item is - the layout name, and the other is a `Layout`_. + 1 を設定した場合、要素とその + + * children: [内部レイアウト... ] + 要素の内部に配置する要素のリストを指定します。 + リストのそれぞれの要素はタプル (もしくは他のシーケンス型) で、 + それの 1 番目の要素はレイアウト名でそれ以降は `Layout`_ です。 .. _Layout: `レイアウト`_ ============================================================================== Revision: df953f8837c6 Author: cocoatomo <cocoa****@gmail*****> Date: Thu Dec 22 09:56:03 2011 Log: merge http://code.google.com/p/python-doc-ja/source/detail?r=df953f8837c6 ============================================================================== Revision: a3d2692258bb Author: cocoatomo <cocoa****@gmail*****> Date: Thu Dec 22 10:00:49 2011 Log: add my name into translators list http://code.google.com/p/python-doc-ja/source/detail?r=a3d2692258bb Modified: /c-api/jptranslation.rst /library/jptranslation.rst ======================================= --- /c-api/jptranslation.rst Mon Dec 5 02:42:01 2011 +++ /c-api/jptranslation.rst Thu Dec 22 10:00:49 2011 @@ -21,4 +21,4 @@ * Yasushi MASUDA * INADA Naoki <inada****@klab*****> - +* cocoatomo ======================================= --- /library/jptranslation.rst Thu Dec 22 04:39:37 2011 +++ /library/jptranslation.rst Thu Dec 22 10:00:49 2011 @@ -53,4 +53,4 @@ * 森本哲也 * osawa <osawa****@sm*****> (2.0) * 打田旭宏 - +* cocoatomo
