跳到主要内容

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

touchBarSegmentedControl.segments

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

touchBarSegmentedControl.selectedIndex

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

touchBarSegmentedControl.mode

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