跳转到主内容

类: TouchBarSegmentedControl

类: TouchBarSegmentedControl

创建一个分段控件(按钮组),其中一个按钮具有选定状态

Process: Main
此类不从 'electron' 模块导出. 它只能作为 Electron API 中其他方法的返回值。

new TouchBarSegmentedControl(options)

  • 选项 对象
    • segmentStyle string (可选) - 按钮组的样式:
      • automatic - 默认。 分段控件的外观是通过窗口的类型和控件在窗口内呈现的位置自动确定的。 映射 NSSegmentStyleAutomatic
      • rounded - 控件的呈现使用圆形风格。 映射 NSSegmentStyleRounded
      • textured-rounded - 控件的呈现使用纹理圆形风格。 映射 NSSegmentStyleTexturedRounded
      • round-rect - 以圆角矩形样式显示控件。 映射 NSSegmentStyleRoundRect
      • round-rect - 以带纹理的矩形样式显示控件。 映射 NSSegmentStyleTexturedSquare
      • capsule - 以胶囊样式的风格显示控件 映射 NSSegmentStyleCapsule
      • small-square - 以小尺寸的矩形样式显示控件 映射 NSSegmentStyleSmallSquare
      • 表示控件的当前段样式。更新此值会立即更新触摸栏中的控件。 映射 NSSegmentStyleSeparated
    • mode string (可选) - 控件的选择模式:
      • single - 默认。 一次选择一个项目,选择一个项目将取消选择先前选定的项目。 映射 NSSegmentSwitchTrackingSelectOne
      • multiple - 可以选多个项。 映射 NSSegmentSwitchTrackingSelectAny
      • buttons - 将段作为按钮使用, 每一段都可以被按下和释放但是不会被标记为激活状态 映射 NSSegmentSwitchTrackingMomentary
    • segments SegmentedControlSegment[] - 被放到控件中的段的集合
    • selectedIndex Integer (optional) - 当前选中的段的下标, 这个值会在用户交互时自动更改 当模式为 multiple 时,它将是最后的选择项。
    • change Function (可选) - 当用户选择一个新的分段时被调用。
      • selectedIndex Integer - 用户选中的段的下标。
      • isSelected boolean - 当前段的选中状态

实例属性

以下为 TouchBarSegmentedControl 实例的可用属性:

touchBarSegmentedControl.segmentStyle

一个 string 值,表示控件当前分段样式。 更新此值会立即更新 touch bar 中的控件。

touchBarSegmentedControl.segments

SegmentedControlSegment[]类型表示的控件中段的集合 改变这个值会立刻刷新touch bar内的控件。 然而改变数组某元素内的嵌套属性不会刷新touch bar

touchBarSegmentedControl.selectedIndex

Integer类型表示的当前选中段 改变这个值会立即触发更新当前段 用户对触摸条的操作会自动更新这个值

touchBarSegmentedControl.mode

一个 string 值,表示控件的当前选择模式。 可以是 single, multiplebuttons.