Class: TouchBarSegmentedControl
Class: TouchBarSegmentedControl
선택된 상태를 가진 버튼 그룹인 세그먼트 컨트롤을 생성한다.
프로세스: 메인
이 클래스는 'electron'
모듈에서 직접 내보내지 않는다. Electron API의 다른 메서드의 반환 값으로만 사용할 수 있다.
new TouchBarSegmentedControl(options)
options
Object
segmentStyle
string (선택 사항) - 세그먼트 스타일:
automatic
- 기본값. 윈도우 타입과 컨트롤이 위치한 곳에 따라 세그먼트 컨트롤의 외관이 자동으로 결정된다. NSSegmentStyleAutomatic
에 매핑된다.
rounded
- 컨트롤이 둥근 스타일로 표시된다. NSSegmentStyleRounded
에 매핑된다.
textured-rounded
- 컨트롤이 질감이 있는 둥근 스타일로 표시된다. NSSegmentStyleTexturedRounded
에 매핑된다.
round-rect
- 컨트롤이 둥근 사각형 스타일로 표시된다. NSSegmentStyleRoundRect
에 매핑된다.
textured-square
- 컨트롤이 질감이 있는 사각형 스타일로 표시된다. NSSegmentStyleTexturedSquare
에 매핑된다.
capsule
- 컨트롤이 캡슐 스타일로 표시된다. NSSegmentStyleCapsule
에 매핑된다.
small-square
- 컨트롤이 작은 사각형 스타일로 표시된다. NSSegmentStyleSmallSquare
에 매핑된다.
separated
- 컨트롤의 세그먼트가 서로 붙어 있지 않으면서 매우 가깝게 표시된다. NSSegmentStyleSeparated
에 매핑된다.
mode
string (선택 사항) - 컨트롤의 선택 모드:
single
- 기본값. 한 번에 하나의 항목만 선택할 수 있으며, 새로운 항목을 선택하면 이전에 선택한 항목이 해제된다. NSSegmentSwitchTrackingSelectOne
에 매핑된다.
multiple
- 여러 항목을 동시에 선택할 수 있다. NSSegmentSwitchTrackingSelectAny
에 매핑된다.
buttons
- 세그먼트가 버튼처럼 동작하며, 각 세그먼트를 눌렀다 놓을 수 있지만 활성 상태로 표시되지 않는다. NSSegmentSwitchTrackingMomentary
에 매핑된다.
segments
SegmentedControlSegment[] - 이 컨트롤에 배치할 세그먼트 배열.
selectedIndex
Integer (선택 사항) - 현재 선택된 세그먼트의 인덱스로, 사용자 상호작용에 따라 자동으로 업데이트된다. 모드가 multiple
인 경우 마지막으로 선택된 항목의 인덱스가 된다.
change
Function (선택 사항) - 사용자가 새로운 세그먼트를 선택할 때 호출된다.
selectedIndex
Integer - 사용자가 선택한 세그먼트의 인덱스.
isSelected
boolean - 사용자 선택 결과로 세그먼트가 선택되었는지 여부.
인스턴스 속성
다음은 TouchBarSegmentedControl
인스턴스에서 사용할 수 있는 속성들이다:
touchBarSegmentedControl.segmentStyle
segmentStyle
은 현재 세그먼트 스타일을 나타내는 문자열이다. 이 값을 업데이트하면 터치 바의 컨트롤이 즉시 업데이트된다.
touchBarSegmentedControl.segments
이 프로퍼티는 SegmentedControlSegment[]
타입의 배열로, 터치바에 표시되는 세그먼트를 나타낸다. 이 값을 업데이트하면 터치바의 컨트롤이 즉시 업데이트된다. 하지만 이 배열 내부의 깊은 프로퍼티를 업데이트하는 경우에는 터치바가 업데이트되지 않는다.
touchBarSegmentedControl.selectedIndex
는 현재 선택된 세그먼트를 나타내는 정수 값이다. 이 값을 변경하면 터치 바에 있는 컨트롤이 즉시 업데이트된다. 또한 사용자가 터치 바와 상호작용하면 이 값이 자동으로 업데이트된다.
touchBarSegmentedControl.mode
컨트롤의 현재 선택 모드를 나타내는 문자열이다. single
, multiple
, buttons
중 하나의 값을 가질 수 있다.