跳转到主要内容

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