uipanel
패널 컨테이너 만들기
설명
p = uipanel
은 현재 Figure에 패널을 만들고 Panel
객체를 반환합니다. 사용할 수 있는 Figure가 없으면 MATLAB®은 figure
함수를 호출하여 Figure를 만듭니다.
p = uipanel(
는 지정된 부모 컨테이너에 패널을 만듭니다. 부모 컨테이너는 parent
)figure
또는 uifigure
함수를 사용하여 만든 Figure이거나 자식 컨테이너일 수 있습니다.
p = uipanel(___,
는 하나 이상의 이름-값 인수를 사용하여 패널 속성을 지정합니다. 위에 열거된 구문에 나와 있는 입력 인수를 조합하여 이 옵션과 함께 사용하십시오. 패널의 속성값은 앱을 Name,Value
)figure
함수로 만들었는지 아니면 uifigure
함수로 만들었는지에 따라 약간 달라집니다.
예제
패널 만들기
패널에 UI 컴포넌트 추가하기
패널 속성값 설정 및 액세스하기
UI Figure에 패널을 만든 다음, 속성값을 지정하여 패널의 모양을 사용자 지정합니다.
fig = uifigure; p = uipanel(fig, ... "Title","Data", ... "BackgroundColor","white");
패널 위치와 크기를 확인합니다.
s = p.Position
s = 1×4
20 20 260 221
패널 Position
속성의 세 번째 요소와 네 번째 요소를 수정하여 패널의 너비와 높이를 업데이트합니다.
p.Position(3:4) = [150 380];
스크롤 가능한 패널 만들기
Scrollable
속성은 패널 테두리 바깥에 컴포넌트가 있을 때 패널 내에서 스크롤이 가능하도록 합니다. 패널이 uifigure
함수를 사용하여 만든 Figure 내에 있는 경우에만 스크롤이 가능합니다. 앱 디자이너는 앱을 만들 때 이 유형의 Figure를 사용합니다.
UI Figure에 패널을 만듭니다. 패널에 UI 컴포넌트 6개를 추가합니다. 처음 두 개의 컴포넌트는 패널의 위쪽 테두리 바깥에 놓이므로 보이지 않습니다.
fig = uifigure; p = uipanel(fig,"Position",[20 20 196 135]); ef1 = uieditfield(p,"Text","Position",[11 165 140 22],"Value","First Name"); ef2 = uieditfield(p,"Text","Position",[11 140 140 22],"Value","Last Name"); ef3 = uieditfield(p,"Text","Position",[11 115 140 22],"Value","Address"); dd = uidropdown(p,"Position",[11 90 140 22],"Items",["Male","Female"]); cb = uicheckbox(p,"Position",[11 65 140 22],"Text","Member"); btn = uibutton(p,"Position",[11 40 140 22],"Text","Send");
Scrollable
속성을 "on"
으로 설정하여 패널에서 스크롤을 활성화합니다. 기본적으로 스크롤 막대는 패널의 위쪽으로 스크롤되어 있습니다.
p.Scrollable = "on";
입력 인수
이름-값 인수
선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN
으로 지정합니다. 여기서 Name
은 인수 이름이고 Value
는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.
예: uipanel(Title="Options")
는 패널 제목을 Options
로 지정합니다.
R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name
을 따옴표로 묶으십시오.
예: uipanel("Title","Options")
는 패널 제목을 Options
로 지정합니다.
참고
여기에 나와 있는 속성은 사용 가능한 속성의 일부에 불과합니다. 전체 목록을 보려면 Panel
항목을 참조하십시오.
Title
— 제목
문자형 벡터 | string형 스칼라 | categorical형 배열
제목으로, 문자형 벡터, string형 스칼라 또는 categorical형 배열로 지정됩니다. 이 속성을 categorical형 배열로 지정할 경우 MATLAB은 배열의 첫 번째 요소만 표시합니다.
MATLAB은 세로줄('|'
) 문자를 줄 바꿈으로 해석하지 않으며, 이를 제목에 세로줄로 표시합니다.
Unicode® 문자를 지정하려면 Unicode 십진수 코드를 char
함수에 전달하십시오. 예를 들어, ['Multiples of ' char(960)]
은 Multiples of
π로 표시됩니다.
BackgroundColor
— 배경색
[0.94 0.94 0.94]
(디폴트 값) | RGB 3색 | 16진수 색 코드 | 'r'
| 'g'
| 'b'
| ...
배경색으로, RGB 3색, 16진수 색 코드 또는 표에 나열된 색 옵션 중 하나로 지정됩니다.
RGB 3색과 16진수 색 코드는 사용자 지정 색을 지정할 때 유용합니다.
RGB 3색은 요소를 3개 가진 행 벡터로, 각 요소는 색을 구성하는 빨간색, 녹색, 파란색의 농도를 지정합니다. 농도의 범위는
[0,1]
이어야 합니다(예:[0.4 0.6 0.7]
).16진수 색 코드는 문자형 벡터 또는 string형 스칼라로, 해시 기호(
#
)로 시작하고 그 뒤에 3자리 또는 6자리의 16진수 숫자(0
에서F
사이일 수 있음)가 옵니다. 이 값은 대/소문자를 구분하지 않습니다. 따라서 색 코드"#FF8800"
,"#ff8800"
,"#F80"
및"#f80"
은 모두 동일합니다.
몇몇의 흔한 색은 이름으로 지정할 수도 있습니다. 다음 표에는 명명된 색 옵션과 그에 해당하는 RGB 3색 및 16진수 색 코드가 나와 있습니다.
색 이름 | 짧은 이름 | RGB 3색 | 16진수 색 코드 | 모양 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" |
다음은 MATLAB이 여러 유형의 플롯에서 사용하는 디폴트 색의 RGB 3색과 16진수 색 코드입니다.
RGB 3색 | 16진수 색 코드 | 모양 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
Position
— 경계와 제목을 포함하는 패널의 위치와 크기
[left bottom width height]
경계와 제목을 포함하는 패널의 위치와 크기로, 요소를 4개 가진 [left bottom width height]
형식의 벡터로 지정됩니다. 다음 표에서는 벡터의 각 요소를 설명합니다.
요소 | 설명 |
---|---|
left | 부모 컨테이너의 왼쪽 내부 가장자리와 패널의 왼쪽 외부 가장자리 사이의 거리 |
bottom | 부모 컨테이너의 내부 하단 가장자리와 패널의 외부 하단 가장자리 사이의 거리 |
width | 패널의 오른쪽과 왼쪽 외부 가장자리 사이의 거리 |
height | 패널의 상단과 하단 외부 가장자리 사이의 거리 |
모든 측정값은 Units
속성으로 지정된 단위로 표시됩니다.
Position
값은 부모 컨테이너의 그리기 가능 영역을 기준으로 합니다. 그리기 가능 영역은 컨테이너의 경계 내부 영역이며 장식(예: 메뉴 모음, 제목)이 차지하는 영역은 포함되지 않습니다.
참고
패널이 그리드 레이아웃 관리자를 부모로 갖는 경우에는 Position
속성의 값이 즉시 업데이트되지 않습니다. Position
값을 사용하여 패널 크기를 기준으로 패널 자식의 크기를 조정하려면 SizeChangedFcn
콜백을 사용하십시오.
Units
— 측정 단위
'pixels'
| 'normalized'
| 'inches'
| 'centimeters'
| 'points'
| 'characters'
측정 단위로, 다음 표에 있는 값 중 하나로 지정됩니다.
단위 값 | 설명 |
---|---|
'pixels' (uifigure 기반 앱의 디폴트 값) | Windows®와 Macintosh 시스템에서 거리(단위: 픽셀)는 시스템 해상도와 관계가 없습니다. 즉, 다음과 같습니다.
Linux® 시스템에서 픽셀 크기는 시스템 해상도에 의해 결정됩니다. |
'normalized' (figure 기반 앱의 디폴트 값) | 이 단위는 부모 컨테이너에 대해 정규화됩니다. 컨테이너의 왼쪽 아래 코너는 |
'inches' | 인치. |
'centimeters' | 센티미터. |
'points' | 포인트. 1포인트는 1/72인치와 같습니다(1인치 = 2.54cm). |
'characters' | 이 단위는 다음과 같이 그래픽스 root 객체의 디폴트 uicontrol 글꼴을 기반으로 합니다.
디폴트 uicontrol 글꼴에 액세스하려면 |
대부분의 MATLAB 앱 작성 기능은 거리를 픽셀 단위로 측정하므로, 권장되는 값은 'pixels'
입니다. uigridlayout
함수를 사용하여 생성된 그리드 레이아웃 관리자를 객체의 부모로 지정함으로써 부모 컨테이너의 크기에 따라 다시 스케일링되는 객체를 만들 수 있습니다. 자세한 내용은 Lay Out Apps Programmatically 항목을 참조하십시오.
팁
panel 객체의 Visible
속성을 "off"
로 설정하면 이 객체에 포함되는 자식 객체(예: 버튼, 버튼 그룹 또는 좌표축)가 부모 패널과 함께 보이지 않게 됩니다. 그러나, 각 자식 객체의 Visible
속성값은 영향을 받지 않습니다.
버전 내역
R2006a 이전에 개발됨R2023a: HighlightColor
가 아닌 BorderColor
속성을 사용하여 패널 테두리 색 변경
BorderColor
속성을 사용하여 uifigure
기반 앱과 figure
기반 앱 모두에서 패널의 테두리 색을 변경할 수 있습니다.
figure
기반 앱에서만 지원되는 HighlightColor
속성보다 BorderColor
속성이 권장됩니다. 하지만 HighlightColor
에 대한 지원을 제거할 계획은 없습니다.
R2022b: uifigure
기반 앱에서 패널 테두리 너비 변경
앱 디자이너 및 uifigure
함수를 사용하여 만든 앱에서 패널의 테두리 너비를 변경하려면 BorderWidth
속성을 사용하십시오.
R2020b: 상호 작용을 끄고 켬
패널이 사용자 상호 작용에 응답할지 여부를 제어하려면 Enable
속성을 사용하십시오. Enable
속성이 'on'
으로 설정된 경우 패널과 상호 작용할 수 있으며 패널 내에 있는 UI 컴포넌트가 활성화된 상태라면 이들과도 상호 작용할 수 있습니다. Enable
속성이 'off'
로 설정된 경우에는 패널 또는 패널의 콘텐츠와 상호 작용할 수 없습니다.
Enable
속성은 앱 디자이너 및 uifigure
기반 앱의 패널에만 지원됩니다.
MATLAB 명령
다음 MATLAB 명령에 해당하는 링크를 클릭했습니다.
명령을 실행하려면 MATLAB 명령 창에 입력하십시오. 웹 브라우저는 MATLAB 명령을 지원하지 않습니다.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)