跳至主要内容

类: 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