跳转到主要内容

类:TouchBarSegmentedControl

类:TouchBarSegmentedControl

创建分段控件(按钮组),其中一个按钮处于选中状态

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

new TouchBarSegmentedControl(options)

  • options Object
    • 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,表示控件当前的分段样式。更新此值会立即更新触摸栏中的控件。

touchBarSegmentedControl.segments

一个 SegmentedControlSegment[] 数组,表示此控件中的分段。更新此值会立即更新触摸栏中的控件。更新此数组中的深层属性**不会更新触摸栏**。

touchBarSegmentedControl.selectedIndex

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

touchBarSegmentedControl.mode

一个 string,表示控件当前的选定模式。可以是 singlemultiplebuttons