类: TouchBarSegmentedControl

类: TouchBarSegmentedControl

创建一个分段控件（一个按钮组），其中一个按钮具有选中状态

进程: 主进程
此类不从 'electron' 模块导出。它仅作为 Electron API 中其他方法的返回值提供。

new TouchBarSegmentedControl(options)

• options 对象
  • segmentStyle 字符串 (可选) - 分段样式
    • automatic - 默认值。分段控件的外观会根据控件显示的窗口类型以及在窗口中的位置自动确定。映射到 NSSegmentStyleAutomatic。
    • rounded - 控件使用圆角样式显示。映射到 NSSegmentStyleRounded。
    • textured-rounded - 控件使用带纹理的圆角样式显示。映射到 NSSegmentStyleTexturedRounded。
    • round-rect - 控件使用圆角矩形样式显示。映射到 NSSegmentStyleRoundRect。
    • textured-square - 控件使用带纹理的方形样式显示。映射到 NSSegmentStyleTexturedSquare。
    • capsule - 控件使用胶囊样式显示。映射到 NSSegmentStyleCapsule。
    • small-square - 控件使用小方形样式显示。映射到 NSSegmentStyleSmallSquare。
    • separated - 控件中的分段显示得彼此非常接近但不接触。映射到 NSSegmentStyleSeparated。
  • mode 字符串 (可选) - 控件的选择模式
    • single - 默认值。一次只能选择一个项目，选择一个会取消之前选中的项目。映射到 NSSegmentSwitchTrackingSelectOne。
    • multiple - 一次可以选择多个项目。映射到 NSSegmentSwitchTrackingSelectAny。
    • buttons - 使分段充当按钮，每个分段都可以按下和释放，但从不标记为活动状态。映射到 NSSegmentSwitchTrackingMomentary。
  • segments SegmentedControlSegment[] - 放置在此控件中的分段数组。
  • selectedIndex 整型 (可选) - 当前选定分段的索引，会随着用户交互自动更新。当模式为 multiple 时，它将是最后选中的项目。
  • change 函数 (可选) - 用户选择新分段时调用。
    • selectedIndex 整型 - 用户选定分段的索引。
    • isSelected 布尔值 - 由于用户选择，分段是否被选中。

实例属性

以下属性在 TouchBarSegmentedControl 实例上可用

touchBarSegmentedControl.segmentStyle

一个 string，表示控件当前的分段样式。更新此值会立即更新 Touch Bar 中的控件。

touchBarSegmentedControl.segments

一个 SegmentedControlSegment[] 数组，表示此控件中的分段。更新此值会立即更新 Touch Bar 中的控件。更新此数组中的深层属性不会更新 Touch Bar。

touchBarSegmentedControl.selectedIndex

一个 Integer，表示当前选定的分段。更改此值会立即更新 Touch Bar 中的控件。用户与 Touch Bar 的交互将自动更新此值。

touchBarSegmentedControl.mode

一个 string，表示控件当前的选择模式。可以是 single、multiple 或 buttons。