Main Content

uilistbox

목록 상자 컴포넌트 만들기

설명

lb = uilistbox는 새 Figure 창에 목록 상자를 만들고 ListBox 객체를 반환합니다. MATLAB®uifigure 함수를 호출하여 Figure를 만듭니다.

예제

lb = uilistbox(parent)는 지정된 부모 컨테이너에 목록 상자를 만듭니다. 부모 컨테이너는 uifigure 함수를 사용하여 만든 Figure이거나 그 자식 컨테이너 중 하나일 수 있습니다.

예제

lb = uilistbox(___,Name,Value)는 하나 이상의 이름-값 인수로 지정된 속성이 있는 목록 상자를 만듭니다. 위에 열거된 구문에 나와 있는 입력 인수를 조합하여 이 옵션과 함께 사용하십시오. 예를 들어, uilistbox("Multiselect","on")은 앱 사용자가 항목 여러 개를 선택할 수 있는 목록 상자를 만듭니다.

예제

모두 축소

UI Figure에 목록 상자를 만듭니다.

fig = uifigure;
lb = uilistbox(fig);

Figure contains an object of type uilistbox.

UI Figure에 목록 상자를 만들고 목록 상자 항목을 지정합니다.

fig = uifigure;
lb = uilistbox(fig,"Items",["Australia","France","Germany"]);

Figure contains an object of type uilistbox.

선택된 항목의 값을 쿼리합니다.

val = lb.Value
val = 
'Australia'

목록 상자 선택을 프로그래밍 방식으로 업데이트합니다.

lb.Value = "Germany";

Figure contains an object of type uilistbox.

UI Figure에 목록 상자를 만듭니다. 앱 사용자가 여러 항목을 선택할 수 있도록 허용합니다.

fig = uifigure;
lb = uilistbox(fig,"Multiselect","on");

Ctrl 키를 누른 채 클릭하여 목록 상자의 항목 여러 개를 선택합니다.

List box in a UI figure with four items: "Item 1", "Item 2", "Item 3", and "Item 4". The pointer is on "Item 4", and both "Item 2" and "Item 4" are selected.

Value 속성은 선택된 모든 항목을 셀형 배열로 저장합니다.

val = lb.Value
val =

  1×2 cell array

    {'Item 2'}    {'Item 4'}

UI Figure에 목록 상자를 만들고, Items 속성을 설정하여 목록 상자에 표시되는 색 이름 목록을 지정합니다.

fig = uifigure;
lb = uilistbox(fig,"Items",["Red","Green","Blue"]);

Figure contains an object of type uilistbox.

항목에 연결된 데이터가 없는 경우, 목록 상자의 Value 속성은 Items의 요소입니다.

val = lb.Value
val = 
'Red'

ItemsData 속성을 설정하여 목록 상자 항목에 16진수 색 데이터를 연결합니다. ItemsData를 설정해도 항목이 앱 사용자에게 표시되는 방식은 변경되지 않습니다.

lb.ItemsData = ["#F00","#0F0","#00F"];

Figure contains an object of type uilistbox.

ItemsData 속성이 비어 있지 않은 경우, 목록 상자의 Value 속성은 ItemsData의 요소입니다.

val = lb.Value
val = 
"#F00"

ItemsData를 지정하면 선택된 항목과 연결된 연산을 보다 쉽게 수행할 수 있습니다. 예를 들어, plot 함수에 직접 16진수 색 값을 전달하여 선택된 색으로 일부 데이터를 플로팅합니다.

plot(1:10,"Color",lb.Value)

Figure contains an axes object. The axes object contains an object of type line.

사용자가 목록 상자 항목을 선택하면 차트의 컬러맵을 업데이트하는 앱을 만듭니다.

colormapApp.m이라는 파일에 다음과 같이 앱을 구현하는 함수를 작성합니다.

  • UI Figure와 그리드 레이아웃 관리자를 만들어 앱의 레이아웃을 설정합니다.

  • 그리드 레이아웃 관리자에서 목록 상자와, 플로팅된 데이터가 있는 UI 좌표축을 만듭니다.

  • UI 좌표축에 대해 컬러맵을 업데이트하는 listBoxValueChanged라는 콜백 함수를 작성한 다음, 이 함수를 목록 상자의 ValueChangedFcn 콜백 속성에 할당합니다. 콜백에 대한 자세한 내용은 프로그래밍 방식으로 만든 앱에 대한 콜백 만들기 항목을 참조하십시오.

function colormapApp
fig = uifigure;
g = uigridlayout(fig,[3 2]);
g.RowHeight = {'1x','fit','1x'};
g.ColumnWidth = {'fit','1x'};

lb = uilistbox(g, ...
    "Items",["Spring","Summer","Autumn","Winter"], ...
    "ItemsData",{spring,summer,autumn,winter});
lb.Layout.Row = 2;
lb.Layout.Column = 1;
ax = uiaxes(g);
ax.Layout.Row = [1 3];
ax.Layout.Column = 2;
surf(ax,peaks)
colormap(ax,spring)

lb.ValueChangedFcn = @(src,event) listBoxValueChanged(src,event,ax);
end

function listBoxValueChanged(src,event,ax)
cmap = event.Value;
colormap(ax,cmap)
end

colormapApp 함수를 실행합니다. 목록 상자에서 항목을 선택하여 컬러맵을 변경합니다.

colormapApp

Figure contains an axes object and an object of type uigridlayout. The axes object contains an object of type surface.

R2023a 이후

서로 다른 이미지를 나타내는 세 개의 항목이 있는 목록 상자를 만듭니다.

fig = uifigure;
lb = uilistbox(fig,"Items",["Peppers","Nebula","Street"]);

목록 상자 항목에 해당하는 아이콘을 갖는 세 개의 스타일을 만듭니다.

s1 = uistyle("Icon","peppers.png");
s2 = uistyle("Icon","ngc6543a.jpg");
s3 = uistyle("Icon","street1.jpg");

목록 상자 항목에 스타일을 추가하여 아이콘을 표시합니다.

addStyle(lb,s1,"item",1);
addStyle(lb,s2,"item",2);
addStyle(lb,s3,"item",3);

List box UI component with three items. Each item has an icon to its left and text that describes the icon.

입력 인수

모두 축소

부모 컨테이너로, uifigure 함수를 사용하여 만든 Figure 객체나 그 자식 컨테이너인 Tab, Panel, ButtonGroup, GridLayout 중 하나로 지정됩니다. 부모 컨테이너를 지정하지 않을 경우 MATLAB은 uifigure 함수를 호출하여 부모 컨테이너 역할을 하는 새 Figure 객체를 만듭니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

예: uilistbox(Items=["Model 1","Model 2","Model 3"])은 목록 상자 항목을 지정합니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

예: uilistbox("Items",["Model 1","Model 2","Model 3"])은 목록 상자 항목을 지정합니다.

참고

여기에 나와 있는 속성은 사용 가능한 속성의 일부에 불과합니다. 전체 목록을 보려면 ListBox 속성 항목을 참조하십시오.

값으로, Items 배열, ItemsData 배열 또는 빈 셀형 배열로 지정됩니다. 기본적으로 ValueItems의 첫 번째 요소입니다.

선택 항목을 지정하지 않으려면 Value를 빈 셀형 배열로 설정하십시오.

ValueItems의 요소로 지정하면 해당 요소와 일치하는 목록 항목이 선택됩니다. ItemsData가 비어 있지 않으면 ValueItemsData의 요소로 설정해야 하며 목록 상자의 목록에서 관련 항목이 선택됩니다.

목록 상자 항목으로, 문자형 벡터로 구성된 셀형 배열, string형 배열 또는 1차원 categorical형 배열로 지정됩니다. 중복 요소가 허용됩니다. 목록 상자는 Items 배열에 있는 요소 수만큼 옵션을 표시합니다. 이 속성을 categorical형 배열로 지정할 경우 MATLAB은 전체 범주 집합이 아닌 배열에 있는 값을 사용합니다.

Items 속성값의 각 요소와 관련된 데이터로, 1×n 숫자형 배열 또는 1×n 셀형 배열로 지정됩니다. 중복 요소가 허용됩니다.

예를 들어, Items 값을 직원 이름으로 설정하면 ItemsData 값을 해당 직원 ID 번호로 설정할 수 있습니다. 앱 사용자에게는 ItemsData 값이 표시되지 않습니다.

ItemsData 값과 Items 값의 배열 요소 수가 일치하지 않으면 다음 중 하나가 발생합니다.

  • ItemsData 값이 비어 있으면 Items 값의 모든 요소가 앱 사용자에게 표시됩니다.

  • ItemsData 값의 요소가 Items 값의 요소보다 많으면 Items 값의 모든 요소가 앱 사용자에게 표시됩니다. 하지만 MATLAB은 ItemsData의 추가 요소를 무시합니다.

  • ItemsData 값이 비어 있지 않지만 Items 값보다 적은 수의 요소가 있으면 앱 사용자에게는 ItemsData 값에 대응하는 요소를 가진 Items 값의 요소만 표시됩니다.

예: {'One','Two','Three'}

예: [10 20 30 40]

여러 개의 항목 선택으로, 'off' 또는 'on'이나 숫자형 값 또는 논리값 1(true) 또는 0(false)으로 지정됩니다. 값 'on'true와 동일하고 값 'off'false와 동일합니다. 따라서 이 속성의 값을 논리값으로 사용할 수 있습니다. 값은 matlab.lang.OnOffSwitchState 유형의 on/off 논리값으로 저장됩니다.

이 속성을 'on'으로 설정하면 사용자가 동시에 여러 항목을 선택할 수 있습니다.

값 변경 콜백으로, 다음 값 중 하나로 지정됩니다.

  • 함수 핸들.

  • 첫 번째 요소가 함수 핸들인 셀형 배열. 이 셀형 배열의 그 다음 요소들은 콜백 함수로 전달할 인수입니다.

  • 유효한 MATLAB 표현식이 포함된 문자형 벡터(권장되지 않음). MATLAB은 이 표현식을 기본 작업 공간에서 실행합니다.

이 콜백 함수는 사용자가 목록 상자에서 다른 항목을 선택할 때 실행됩니다. Value 속성 설정이 프로그래밍 방식으로 변경되는 경우에는 실행되지 않습니다.

이 콜백 함수는 사용자와 목록 상자의 상호 작용에 대한 특정 정보에 액세스할 수 있습니다. MATLAB은 이 정보를 콜백 함수에 대한 두 번째 인수로서 ValueChangedData 객체에 전달합니다. 앱 디자이너에서는 이 인수를 event라고 부릅니다. 점 표기법을 사용하여 객체 속성을 쿼리할 수 있습니다. 예를 들어, event.PreviousValue는 목록 상자의 이전 값을 반환합니다. ValueChangedData 객체는 문자형 벡터로 지정된 콜백 함수에 사용할 수 없습니다.

다음 표에는 ValueChangedData 객체의 속성 목록이 나열되어 있습니다.

속성
Value앱 사용자의 가장 최근 상호 작용 직후의 목록 상자 값
PreviousValue앱 사용자의 가장 최근 상호 작용 직전의 목록 상자 값
Source콜백을 실행하는 컴포넌트
EventName'ValueChanged'

콜백을 작성하는 방법에 대한 자세한 내용은 앱 디자이너에서 콜백 사용하기 항목을 참조하십시오.

부모 컨테이너를 기준으로 한 목록 상자의 위치 및 크기로, 벡터 [left bottom width height]로 지정됩니다. 다음 표에서는 벡터의 각 요소를 설명합니다.

요소설명
left부모 컨테이너의 왼쪽 내부 가장자리와 목록 상자의 왼쪽 외부 가장자리 사이의 거리
bottom부모 컨테이너의 내부 하단 가장자리와 목록 상자의 외부 하단 가장자리 사이의 거리
width목록 상자의 오른쪽과 왼쪽 외부 가장자리 사이의 거리
height목록 상자의 상단과 하단 외부 가장자리 사이의 거리

모든 측정값은 픽셀 단위입니다.

Position 값은 부모 컨테이너의 그리기 가능 영역을 기준으로 합니다. 그리기 가능 영역은 컨테이너의 경계 내부 영역이며 장식(예: 메뉴 모음, 제목)이 차지하는 영역은 포함되지 않습니다.

예: [100 100 100 200]

scroll 함수를 사용하면 프로그래밍 방식으로 목록 상자 항목을 스크롤하거나 목록의 맨 위 또는 맨 아래 항목을 표시할 수 있습니다.

버전 내역

R2016a에 개발됨

모두 확장