listdlg (MATLAB Function Reference)

(translator=roro, ChineseSource=roro-20020612-3\listdlg.html, EnglishSource=c:\matlabr12\help\techdoc\ref\listdlg.html)

開啟條列式選擇對話盒

Syntax

[Selection,ok] = listdlg('ListString',S,...)

Description

[Selection,ok] = listdlg('ListString',S) 開啟一典型對話盒其可讓使用者從名冊中選擇一個或更多的選項。Selection 為含有選項字串的向量（對單一選項模式而言，其長度為 1）。Selection 為 [] 當 ok 是 0。若按下 OK 按鈕時ok 為 1，若按下 Cancel 時即為 0。當有數個選項已被選擇時，對一選項按兩次或是按下Return 和按下 OK 按鈕有相同的效果。對話盒有一 Select all 按鈕（當在複數選項模式）可讓使用者選擇所有的選項。

下表敘述參數/對應的值：

參數
敘述

'ListString'
字串的異質陣列其定義對話盒的選項。

'SelectionMode'
字串其代表一個或很多選項可被選擇：'single' 或 'multiple' （預設值）。

'ListSize'
以像素為單位列出選項盒的尺寸，用兩個元素的向量表示，即 [width height]。預設值為 [160 300]。

'InitialValue'
一向量其元素為初始時已被選擇的選項。預設為 1，即第一個選項。

'Name'
對話盒標題的字串。預設值為 ''。

'PromptString'
在對話盒上出現的文件，以字串矩陣或字串異質陣列存取。預設值為 {}。

'OKString'
針對 OK 按鈕的字串。預設值為 'OK'。

'CancelString'
針對 Cancel 按鈕的字串。預設值為 'Cancel'。

'uh'
Uicontrol 按鈕的高度，以像素為單位。預設值為 18。

'fus'
Frame/uicontrol 的空白，以像素為單位。預設值為 8。
'ffs'
Frame/figure 的空白，以像素為單位。預設值為 8。

參數	敘述
`'ListString'`	字串的異質陣列其定義對話盒的選項。
`'SelectionMode'`	字串其代表一個或很多選項可被選擇：`'single'` 或 `'multiple'` （預設值）。
`'ListSize'`	以像素為單位列出選項盒的尺寸，用兩個元素的向量表示，即 `[width height]`。預設值為 `[160 300]`。
`'InitialValue'`	一向量其元素為初始時已被選擇的選項。預設為 1，即第一個選項。
`'Name'`	對話盒標題的字串。預設值為 ''。
`'PromptString'`	在對話盒上出現的文件，以字串矩陣或字串異質陣列存取。預設值為 {}。
`'OKString'`	針對 OK 按鈕的字串。預設值為 `'OK'。`
`'CancelString'`	針對 Cancel 按鈕的字串。預設值為 '`Cancel`'。
`'uh'`	Uicontrol 按鈕的高度，以像素為單位。預設值為 18。
`'fus'`	Frame/uicontrol 的空白，以像素為單位。預設值為 8。
`'ffs'`	Frame/figure 的空白，以像素為單位。預設值為 8。

Example

此範例顯示一對話盒其可讓使用者從現行目錄中選擇一檔案。函式回傳一向量。第一個元素為選擇檔案的索引；若沒有選擇，則第二個元素為 0，否則為 1。

d = dir;
str = {d.name};
[s,v] = listdlg('PromptString','Select a file:',...
                'SelectionMode','single',...
                'ListString',str)

See Also

dir

linspace 　 load