NAME

ComboBox - ComboBox 元件

建立 CREATION

ComboBox pathName ?option value...?

描述 DESCRIPTION

ComboBox 元件使使用者能在用 values 選項給出的一個列表中選擇一個值。透過按 ArrowButton，或在 ComboBox 的 editable 的值是 false 的時候在錄入欄中點選，彈出可能值的列表。如果 ComboBox 的 editable 的值是 true 並且錄入欄獲得了聚焦，使用者可以按上下箭頭鍵來修改它的值。如果當前值精確的匹配在列表中的一個值，則顯示列表中的前一個(向上箭頭鍵)或下一個(向下箭頭鍵)值。如果當前值匹配在列表中的一個值的開始，則顯示這個值。如果當前值不匹配任何東西，則顯示第一個值。

元件特有選項 WIDGET-SPECIFIC OPTIONS

-height: 為個這個視窗指定想要的高度，以行為單位(in lines)。如果它小於等於零，則這個視窗要求的高度只是足夠大得裝下在列表框中所有的元素。
-modifycmd: 指定在使用者透過在列表框中選擇一個值或按上下箭頭鍵來修改 ComboBox 框的值的時候呼叫的一個 Tcl 命令。
-postcommand: 指定在對映 ComboBox 的列表框之前呼叫的一個 Tcl 命令。
-values: 指定在 ComboBox 的列表框中顯示的值。

元件命令

pathName bind ?arg...?

在錄入元件上設定繫結。

pathName cget option

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

pathName configure ?option? ?value option value ...?

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

pathName getvalue

返回 ComboBox 的當前文字在值的列表中的索引，如果它不匹配任何值則返回 -1。

pathName setvalue index