aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorfaiface <faiface2202@gmail.com>2019-05-07 01:18:17 +0200
committerfaiface <faiface2202@gmail.com>2019-05-07 01:18:17 +0200
commit875b12b4a0c49f7bc0ae3ba6c4a0b842f2a8653f (patch)
treeb7f5a97599a9ab7eb584c61cc5948ab6eb1a1aba
parentd80d49a3f84c112ae8a30913023214fd975dbe73 (diff)
downloadgui-875b12b4a0c49f7bc0ae3ba6c4a0b842f2a8653f.zip
correctly document the resize event
-rw-r--r--README.md6
-rw-r--r--env.go2
2 files changed, 5 insertions, 3 deletions
diff --git a/README.md b/README.md
index eadc8a4..e2d906c 100644
--- a/README.md
+++ b/README.md
@@ -91,8 +91,8 @@ Examples of `Event` strings are: `"wi/close"`, `"mo/move/104/320"`, `"kb/type/71
```go
switch {
-case event.Matches("resize/%d/%d", &w, &h):
- // environment resized to (w, h)
+case event.Matches("resize/%d/%d/%d/%d", &x0, &y0, &x1, &y1):
+ // environment resized to (x0, y0, x1, y1)
case event.Matches("wi/close"):
// window closed
case event.Matches("mo/move/%d/%d", &x, &y):
@@ -116,7 +116,7 @@ case event.Matches("kb/repeat/%s", &key):
This shows all the possible events that a window can produce. You can find a little more info (especially on the keys) [here in GoDoc](https://godoc.org/github.com/faiface/gui/win#Win).
-The `"resize"` event is not prefixed with `"wi/"`, because it's not specific to windows.
+The `"resize"` event is not prefixed with `"wi/"`, because it's not specific to windows. It is also guaranteed to be the first event produced by any `Env`.
You can also match only specific buttons/keys, or ignore them:
diff --git a/env.go b/env.go
index 85765e4..2515417 100644
--- a/env.go
+++ b/env.go
@@ -15,6 +15,8 @@ import (
// supplied draw.Image, which is the drawing area of the Env and returns a rectangle
// covering the whole part of the image that got changed.
//
+// An Env guarantees to produce a "resize/<x0>/<y0>/<x1>/<y1>" event as its first event.
+//
// The Events() channel must be unlimited in capacity. Use MakeEventsChan() to create
// a channel of events with an unlimited capacity.
//