メインコンテンツにスキップ

クラス: TouchBarSegmentedControl

クラス: TouchBarSegmentedControl

セグメント化されたコントロール(ボタンのグループ)を作成します。そのうち1つのボタンが選択された状態になります。

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

new TouchBarSegmentedControl(options)

  • options オブジェクト
    • segmentStyle string (オプション) - セグメントのスタイル
      • automatic - デフォルト。セグメント化されたコントロールの表示は、コントロールが表示されるウィンドウの種類と、ウィンドウ内の位置に基づいて自動的に決定されます。 NSSegmentStyleAutomatic にマッピングされます。
      • rounded - コントロールは、丸みを帯びたスタイルで表示されます。 NSSegmentStyleRounded にマッピングされます。
      • textured-rounded - コントロールは、テクスチャ付きの丸みを帯びたスタイルで表示されます。 NSSegmentStyleTexturedRounded にマッピングされます。
      • round-rect - コントロールは、丸い矩形スタイルで表示されます。 NSSegmentStyleRoundRect にマッピングされます。
      • textured-square - コントロールは、テクスチャ付きの正方形スタイルで表示されます。 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

コントロールの現在の選択モードを表す stringsinglemultiple、または buttons になります。