NoteBook(3tk)

NAME
NoteBook - 筆記本管理器組件

創建 CREATION
NoteBook pathName ?option value...?

描述 DESCRIPTION
NoteBook 組件管理一組頁面並顯示其中一個。

組件特有選項 WIDGET-SPECIFIC OPTIONS

-height
    為頁面指定想要的高度。如果這個選項等於零(預設的)，則這個視窗根本不要求任何大小。在這種情況下，使用者可以調用 NoteBook::compute_size 來使 NoteBook 足夠大得包含最大的頁面。

-homogeneous
    指定頁面的標簽是否有相同的寬度。

-side (read-only)
    指定靠那邊放置頁面的標簽。必須是 top 或 bottom 之一。目前只實現了 top。

-width
    為頁面指定想要的寬度。如果這個選項等於零(預設的)，則這個視窗根本不要求任何大小。在這種情況下，使用者可以調用 NoteBook::compute_size 來使 NoteBook 足夠大得包含最大的頁面。

組件命令

pathName bindtabs event script
    這個命令把在用 event 給出的時間序列發生時要執行的一個命令關聯到一個標貼(tab)上。把在它的上面發生事件的頁面的標識符添加到這個命令上。

pathName cget option
    返回用 option 給出的配置選項的當前值。Option 可以是能被建立命令接受的任何值。

pathName compute_size
    調用這個命令使筆記本足夠大得包含最大的頁。注意如果所有的頁面都使用了 -createcmd，則它們沒有要求的大小。

pathName configure ?option? ?value option value ...?
    查詢或修改這個組件的配置選項。如果未指定 option ，則返回描述 pathName 的所有可獲得的選項的一個列表。如果指定了不帶 value 的 option，則這個命令返回描述這個指名的 option 的一個列表(這個列表與未指定 option 所返回的值的相應的子集是一樣的)。如果指定了一個或多個選項-值 對，則這個命令把給定的組件選項修改為給定的值；在這種情況下這個命令返回一個空串。Option 可以是能被建立命令接受的任何值。只讀選項不可修改。

pathName delete page ?destroyframe?
    刪除這個頁面。如果 destroyframe 是 1 (預設的)，銷毀與 page 相關的框架。如果 destroyframe 是 0，則不銷毀這個框架，以便將來用 insert 調用重新使用同一個的 page。

pathName getframe page
    返回頁面 page 的路徑名。

pathName index page
    返回對應於這個項目的數值索引。

pathName insert index page ?option value...?
    在頁面列表中位置 index 上插入用 page 標識的一個新頁面。index 必須是數值或 end。返回這個新頁面的路徑名。 -createcmd 指定在第一次提升(raise)這個頁面的時候調用的命令。 -image 為這個頁面指定在標簽的左面顯示的圖像。 -leavecmd 指定在要離開(leave)一個頁面的時候調用的一個命令。如果這個頁面可以離開則這個命令必須返回 0，如果可以離開則返回 1。 -raisecmd 指定在每次提升這個頁面的時候調用的命令。 -state 指定這個頁面的狀態。必須是 normal 或 disabled. -text 為這個頁面指定要顯示的一個標簽。

pathName itemcget page option
    返回這個項目的一個配置選項的當前值。Option 可以是這個項目建立命令能接受的任何值。

pathName itemconfigure page ?option? ?value option value ...?
    這個命令類似於 configure 命令，但是它為單獨的項目提供選項，而 configure 為作為整體的組件提供選項。Options 可以是項目建立組件命令可接受的任何值。如果指定了選項，則依據命令的指示修改選項並且命令返回一個空串。如果未指定選項，則返回描述這個項目的當前選項的一個列表。只讀選項不能修改。

pathName move page index
    把 page 的標貼移動到到索引 index。

pathName page first ?last?
    反對使用它，建議替代為 pages。 如果省略了 last，則返回在索引 first 上的頁面，如果 first 引用一個不存在的頁面則返回空串。如果指定了 last，則這個命令返回一個列表，它的元素是在 first 和 last 之間(包含二者)的所有頁面。first 和 last 二者可以是索引的任何標準形式。

pathName pages ?first? ?last?
    如果省略了 first 和 last，則返回所有頁面的一個列表。如果指定了 first 而省略了 last，則返回在索引 first 上的頁面，如果 first 引用一個不存在的元素則返回空串。如果指定了 first 和 last，則這個命令返回一個列表，它的元素是在 first 和 last 之間(包含二者)的所有頁面。first 和 last 二者可以是索引的任何標準形式。

pathName raise ?page?
    提升(raise)頁面 page，如果省略了 page 則返回突出的(raised)頁面。

pathName see page
    卷繞(scroll)標簽來使頁面 page 的標簽可見。

[中文版維護人]
寒蟬退士

[中文版最新更新]
2001/05/11

《中國 Linux 論壇 man 手冊頁翻譯計劃》:
http://cmpp.linuxforum.net