Instance Method インスタンスメソッド

gesture(_:including:)

Attaches a gesture to the view with a lower precedence than gestures defined by the view. ジェスチャをビューに添付します、ビューによって定義されるジェスチャより低い優先度で。

Declaration 宣言 

func gesture<T>(_ gesture: T, including mask: GestureMask = .all) -> some View where T : Gesture

Parameters パラメータ

gesture

A gesture to attach to the view.

mask

A value that controls how adding this gesture to the view affects other gestures recognized by the view and its subviews. Defaults to all.

Discussion 議論

Use this method when you need to attach a gesture to a view. The example below defines a custom gesture that prints a message to the console and attaches it to the view’s VStack. Inside the VStack a red heart Image defines its own TapGesture handler that also prints a message to the console, and blue rectangle with no custom gesture handlers. Tapping or clicking the image prints a message to the console from the tap gesture handler on the image, while tapping or clicking the rectangle inside the VStack prints a message in the console from the enclosing vertical stack gesture handler.


struct GestureExample: View {
    @State private var message = "Message"
    let newGesture = TapGesture().onEnded {
        print("Tap on VStack.")
    }


    var body: some View {
        VStack(spacing:25) {
            Image(systemName: "heart.fill")
                .resizable()
                .frame(width: 75, height: 75)
                .padding()
                .foregroundColor(.red)
                .onTapGesture {
                    print("Tap on image.")
                }
            Rectangle()
                .fill(Color.blue)
        }
        .gesture(newGesture)
        .frame(width: 200, height: 200)
        .border(Color.purple)
    }
}

See Also 参照

Taps and Gestures

func onTapGesture(count: Int, perform: () -> Void) -> some View
Adds an action to perform when this view recognizes a tap gesture. このビューがタップジェスチャを認識する時に実行するアクションを加えます。
func onLongPressGesture(minimumDuration: Double, maximumDistance: CGFloat, perform: () -> Void, onPressingChanged: ((Bool) -> Void)?) -> some View
Adds an action to perform when this view recognizes a long press gesture. このビューが長押しジェスチャを認識する時に実行するアクションを加えます。
func onLongPressGesture(minimumDuration: Double, perform: () -> Void, onPressingChanged: ((Bool) -> Void)?) -> some View
Adds an action to perform when this view recognizes a long press gesture. このビューが長押しジェスチャを認識する時に実行するアクションを加えます。
func onLongPressGesture(minimumDuration: Double, pressing: ((Bool) -> Void)?, perform: () -> Void) -> some View
Adds an action to perform when this view recognizes a long press gesture. このビューが長押しジェスチャを認識する時に実行するアクションを加えます。
Deprecated 非推奨
func highPriorityGesture<T>(T, including: GestureMask) -> some View
Attaches a gesture to the view with a higher precedence than gestures defined by the view. ジェスチャをビューに添付します、ビューによって定義されるジェスチャより高い優先度で。
func simultaneousGesture<T>(T, including: GestureMask) -> some View
Attaches a gesture to the view to process simultaneously with gestures defined by the view. ジェスチャをビューに添付します、ビューによって定義されるジェスチャと同期的に処理することになります。