メインコンテンツへ飛ぶ

クラス: TouchBarSegmentedControl

クラス: TouchBarSegmentedControl​

1つのボタンが選択状態になっているセグメントコントロール (ボタングループ) を作成します

プロセス: メイン
このクラスは 'electron' モジュールからはエクスポートされません。 Electron API では、他のメソッドの戻り値としてのみ利用できます。

new TouchBarSegmentedControl(options)​

  • options Object
    • segmentStyle string (任意) - 以下のセグメントのスタイルのいずれかです。
      • automatic - デフォルト。 セグメントコントロールの見た目は、コントロールを表示しているウインドウタイプとウインドウ内の位置に基づいて自動決定されます。 NSSegmentStyleAutomatic に対応します。
      • rounded - コントロールは丸みのあるスタイルで表示されます。 NSSegmentStyleRounded に対応します。
      • textured-rounded - コントロールは、テクスチャ付きの丸みのあるスタイルで表示されます。 NSSegmentStyleTexturedRounded に対応します。
      • round-rect - コントロールは丸角のスタイルで表示されます。 Maps to NSSegmentStyleRoundRect.
      • textured-rounded - コントロールは、テクスチャ付きの丸角のスタイルで表示されます。 NSSegmentStyleTexturedSquare に対応します。
      • capsule - コントロールはカプセル状のスタイルで表示されます。 NSSegmentStyleCapsule に対応します。
      • small-square - コントロールは小さな正方形のスタイルで表示されます。 NSSegmentStyleSmallSquare に対応します。
      • separated - コントロール内のセグメントは、互いに非常に近く表示されますが、接触しません。 NSSegmentStyleSeparated に対応します。
    • mode string (任意) - コントロールの選択モード。
      • single - 既定値。 一度に 1 つアイテムを選択し、どれかを選択すると、前に選択したアイテムの選択が解除されます。 NSSegmentSwitchTrackingSelectOne に対応します。
      • multiple - 一度に複数のアイテムを選択できます。 NSSegmentSwitchTrackingSelectAny に対応します。
      • buttons - セグメントをボタンとして動作させ、各セグメントを押して離すことができますが、アクティブとしてマークされることはありません。 NSSegmentSwitchTrackingMomentary に対応します。
    • segments SegmentedControlSegment[] - このコントロールに配置するセグメントの配列。
    • selectedIndex Integer (任意) - ユーザの操作によって自動的に更新される、現在選択されているセグメントのインデックス。 multiple モードでは、これは最後に選択したアイテムになります。
    • change Function (任意) - ユーザが新しいセグメントを選択したときに呼ばれます。
      • selectedIndex Integer - ユーザが選択したセグメントのインデックス。
      • isSelected boolean - ユーザの選択結果として、セグメントが選択されたかどうか。

インスタンスプロパティ​

TouchBarSegmentedControl のインスタンスには以下のプロパティがあります。

touchBarSegmentedControl.segmentStyle​

コントロールの現在のセグメントスタイルを表す string。 この値を更新すると、タッチバー内のコントロールがすぐに更新されます。

touchBarSegmentedControl.segments​

このコントロールのセグメントを表す SegmentedControlSegment[] 配列。 この値を更新すると、タッチバーのコントロールがすぐに更新されます。 この配列の要素の中のプロパティを更新しても タッチバーは更新されません。

touchBarSegmentedControl.selectedIndex​

現在選択されているセグメントを表す Integer。 この値を変更すると、タッチバーのコントロールがすぐに更新されます。 ユーザがタッチバーに接触すると、この値が自動的に更新されます。

touchBarSegmentedControl.mode​

コントロールの、現在の選択モードを表す stringです。 single、multiple、buttons のいずれかにできます。