uigauge

계기판 컴포넌트 만들기

구문

g = uigauge

g = uigauge(parent)

g = uigauge(style)

g = uigauge(parent,style)

g = uigauge(___,Name,Value)

설명

g = uigauge는 새 Figure에 원형 계기판을 만들고 Gauge 객체를 반환합니다. MATLAB^®은 uifigure 함수를 호출하여 Figure를 만듭니다.

g = uigauge(parent)는 지정된 부모 컨테이너에 계기판을 만듭니다. 부모 컨테이너는 Figure 객체이거나 그 자식 컨테이너 중 하나일 수 있습니다.

g = uigauge(style)은 지정된 스타일의 계기판을 만듭니다. 계기판 스타일은 "circular", "linear", "ninetydegree" 또는 "semicircular"일 수 있습니다.

g = uigauge(parent,style)은 지정된 부모 컨테이너에 지정된 스타일의 계기판을 만듭니다.

g = uigauge(___,Name,Value)는 위에 열거된 구문에 나와 있는 입력 인수 조합 외에, 이름-값 인수를 하나 이상 사용하여 계기판 속성을 지정합니다. 예를 들어, uigauge("Value",10)은 값을 10으로 설정하여 계기판을 만듭니다.

예제

원형 계기판 만들기

UI Figure에 원형 계기판을 만듭니다.

fig = uifigure("Position",[100 100 300 300]);
cg = uigauge(fig);

그리드 레이아웃 관리자에서 계기판 만들기

UI Figure와 2×3 그리드 레이아웃 관리자를 만듭니다. 스타일이 다른 4개의 계기판을 만들고 그리드 레이아웃 관리자를 각 계기판의 부모 컨테이너로 지정합니다. 선형 계기판을 그리드의 하단 행 전체에 걸쳐 배치합니다.

fig = uifigure("Position",[100 100 470 220]);
g = uigridlayout(fig,[2 3]);
g.RowHeight = {'1x','fit'};
cg = uigauge(g);
ng = uigauge(g,"ninetydegree");
sg = uigauge(g,"semicircular");
lg = uigauge(g,"linear");
lg.Layout.Column = [1 3];

계기판 속성 설정 및 액세스하기

UI Figure에 원형 계기판을 만듭니다.

fig = uifigure("Position",[100 100 300 300]);
cg = uigauge(fig);

계기판 제한과 값을 지정합니다.

cg.Limits = [-50 50];
cg.Value = 20;

계기판의 주 눈금 값에 액세스합니다.

mt = cg.MajorTicks

mt = 1×6

   -50   -30   -10    10    30    50

선형 계기판 방향 지정하기

UI Figure에 세로 선형 계기판을 만듭니다.

fig = uifigure("Position",[100 100 300 300]);
lg = uigauge(fig,"linear","Orientation","vertical");

눈금 및 눈금 레이블 지정하기

UI Figure에 90도 계기판을 만듭니다.

fig = uifigure("Position",[100 100 300 300]);
ng = uigauge(fig,"ninetydegree");

주 눈금 수를 변경하고 주 눈금에 대응하는 눈금 레이블을 지정하고 보조 눈금을 제거하여 계기판 모양을 사용자 지정합니다.

ng.MajorTicks = 0:50:100;
ng.MajorTickLabels = ["Low","Med","High"];
ng.MinorTicks = [];

스케일 색 및 색 제한 지정

UI Figure에 반원형 계기판을 만듭니다.

fig = uifigure("Position",[100 100 300 300]);
sg = uigauge(fig,"semicircular");

ScaleColors 속성과 ScaleColorLimits 속성을 설정하여 계기판의 높은 값의 색을 변경합니다.

sg.ScaleColors = ["yellow","red"];
sg.ScaleColorLimits = [60 80; 80 100];

입력 인수

parent — 부모 컨테이너

Figure 객체 (디폴트 값) | Tab 객체 | Panel 객체 | ButtonGroup 객체 | GridLayout 객체

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

style — 계기판의 스타일

"circular" (디폴트 값) | "linear" | "ninetydegree" | "semicircular"

계기판의 스타일로, 다음 값 중 하나로 지정됩니다.

스타일	모양
"circular"
"linear"
"ninetydegree"
"semicircular"

이름-값 인수

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

예: uigauge(Value=10)은 계기판 값을 10으로 지정합니다.

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

예: uigauge("Value",10)은 계기판 값을 10으로 지정합니다.

계기판의 각 스타일은 서로 다른 속성 모음을 지원합니다. 전체 속성 목록과 각 스타일에 대한 설명을 보려면 관련 계기판 컴포넌트 페이지를 참조하십시오.

• Gauge

• LinearGauge

• NinetyDegreeGauge

• SemicircularGauge

버전 내역

R2016a에 개발됨

참고 항목

함수

• uifigure

객체

• Gauge | LinearGauge | NinetyDegreeGauge | SemicircularGauge

툴

• 앱 디자이너