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 중 하나의 값을 가질 수 있다.