tcell/mouse.go

81 lines
2.0 KiB
Go

// Copyright 2015 The TCell Authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use file except in compliance with the License.
// You may obtain a copy of the license at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package tcell
import (
"time"
)
// EventMouse is a mouse event. It is sent on either mouse up or mouse down
// events. It is also sent on mouse motion events - if the terminal supports
// it. We make every effort to ensure that mouse release events are delivered.
// Hence, click drag can be identified by a motion event with the mouse down,
// without any intervening button release.
//
// Mouse wheel events, when reported, may appear on their own as individual
// impulses.
//
// Most terminals cannot report the state of more than one button at a time --
// and few can report motion events.
//
// Applications can inspect the time between events to figure out double clicks
// and such.
type EventMouse struct {
t time.Time
btn ButtonMask
mod ModMask
x int
y int
}
func (ev *EventMouse) When() time.Time {
return ev.t
}
func (ev *EventMouse) Buttons() ButtonMask {
return ev.btn
}
func (ev *EventMouse) Modifiers() ModMask {
return ev.mod
}
func (ev *EventMouse) Position() (int, int) {
return ev.x, ev.y
}
func NewEventMouse(x, y int, btn ButtonMask, mod ModMask) *EventMouse {
return &EventMouse{t: time.Now(), x: x, y: y, btn: btn, mod: mod}
}
// BtnMask is a mask of mouse buttons.
type ButtonMask int16
const (
Button1 ButtonMask = 1 << iota
Button2
Button3
Button4
Button5
Button6
Button7
Button8
WheelUp
WheelDown
WheelLeft
WheelRight
)
const ButtonNone ButtonMask = 0