SwitchDelegate QML Type
オン/オフを切り替え可能なスイッチインジケーターを備えたアイテムデリゲート。詳細...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
プロパティ
- position : real
- visualPosition : real
詳細説明
SwitchDelegate は、オン(チェック済み)またはオフ(チェックなし)に切り替え可能なアイテムデリゲートを提供します。SwitchDelegate は通常、一連のオプションから 1 つまたは複数のオプションを選択するために使用されます。オプションの数が少ない場合や、オプションを一意に識別する必要がある場合は、代わりにSwitch の使用を検討してください。
SwitchDelegateは、ItemDelegate からAPIを継承しており、 はAbstractButton から継承されています。たとえば、text を設定したり、AbstractButton APIを使用してclicks に反応させたりすることができます。スイッチデリゲートの状態は、checked プロパティで設定できます。
ListView {
model: ["Option 1", "Option 2", "Option 3"]
delegate: SwitchDelegate {
text: modelData
}
}「SwitchDelegateおよびDelegate コントロールのカスタマイズ」も参照してください 。
プロパティのドキュメント
position : real [read-only]
このプロパティは、サムインジケーターの論理的な位置を保持します。
この位置は、インジケーターのサイズに対する割合として、0.0 ~1.0 の範囲で表されます。この位置は、例えば、サムが中間点を越えてドラッグされたかどうかを判断するために使用できます。サムインジケーターを可視化するには、代わりに右から左への読み込みに対応した `visualPosition ` を使用する必要があります。
visualPositionも参照してください 。
visualPosition : real [read-only]
このプロパティは、サムインジケーターの表示位置を保持します。
位置は、インジケータのサイズに対する割合として表され、範囲は0.0 ~1.0 です。コントロールがmirrored の場合、値は1.0 - position となります。これにより、右から左へのサポートを考慮したサムインジケータの視覚化に適した値となります。 例えば、サムが中間点を越えてドラッグされたかどうかを判定するには、代わりに論理値position を使用する必要があります。
positionも参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.