跳至主要內容

類別: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

表示控制項目前分段樣式的 字串。更新此值會立即更新觸控列中的控制項。

touchBarSegmentedControl.segments

表示此控制項中分段的 SegmentedControlSegment[] 陣列。更新此值會立即更新觸控列中的控制項。更新此陣列內的深層屬性不會更新觸控列

touchBarSegmentedControl.selectedIndex

表示目前選取分段的 整數。變更此值會立即更新觸控列中的控制項。與觸控列的使用者互動會自動更新此值。

touchBarSegmentedControl.mode

表示控制項目前選取模式的 字串。可以是 singlemultiplebuttons