Skip to main content

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