androidannotations · WonderCsabo · Sep 12, 2015 · Sep 7, 2015 · Sep 7, 2015 · Sep 7, 2015
diff --git a/...core/androidannotations-api/src/main/java/org/androidannotations/annotations/KeyDown.java b/...core/androidannotations-api/src/main/java/org/androidannotations/annotations/KeyDown.java
@@ -0,0 +1,103 @@
+/**
+ * Copyright (C) 2010-2015 eBusiness Information, Excilys Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this 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 org.androidannotations.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * <p>
+ * This annotation is intended to be used on methods to receive action down
+ * event on a key. This annotation can be used on methods of classes which
+ * implements {@link android.view.KeyEvent.Callback}.
+ * </p>
+ * <p>
+ * The annotation value should be one or several of
+ * {@link android.view.KeyEvent} constant fields which name contains KEYCODE. If
+ * not set, the method name will be used as the {@link android.view.KeyEvent}
+ * .KEYCODE_* field name.
+ * </p>
+ * <p>
+ * The method may return a <code>boolean</code>, <code>void</code>, or a
+ * {@link Boolean}. If returning void, it will be considered as
+ * returning true (ie: the method has handled the event).
+ * </p>
+ * <p>
+ * The method MAY have one parameter:
+ * </p>
+ * <ul>
+ * <li>A {@link android.view.KeyEvent} parameter to know which key has been down
+ * </li>
+ * </ul>
+ * 
+ * <p>
+ * Example :
+ * </p>
+ * 
+ * <pre>
+ * &#064;EActivity
+ * public class MyActivity extends Activity {
+ *
+ * 	&#064;KeyDown
+ * 	void enter() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyDown
+ * 	void onEnter() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyDown
+ * 	void onEnterPressed() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyDown
+ * 	void enterPressed() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyDown(KeyEvent.KEYCODE_0)
+ * 	void keyZeroIsDown(KeyEvent keyEvent) {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyDown({ KeyEvent.KEYCODE_M, KeyEvent.KEYCODE_N })
+ * 	boolean multipleKeys(KeyEvent keyEvent) {
+ * 		return false;
+ * 	}
+ * }
+ * </pre>
+ *
+ * @see android.view.KeyEvent
+ * @see android.view.KeyEvent.Callback
+ * @see android.view.KeyEvent.Callback#onKeyDown(int, android.view.KeyEvent)
+ */
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.METHOD)
+public @interface KeyDown {
+
+	/**
+	 * The {@link android.view.KeyEvent} class constants which name contains
+	 * KEYCODE.
+	 *
+	 * @return the value of the key code
+	 */
+	int[] value() default {};
+}
diff --git a/...androidannotations-api/src/main/java/org/androidannotations/annotations/KeyLongPress.java b/...androidannotations-api/src/main/java/org/androidannotations/annotations/KeyLongPress.java
@@ -0,0 +1,103 @@
+/**
+ * Copyright (C) 2010-2015 eBusiness Information, Excilys Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this 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 org.androidannotations.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * <p>
+ * This annotation is intended to be used on methods to receive long press event
+ * on a key. This annotation can be used on methods of classes which implements
+ * {@link android.view.KeyEvent.Callback}.
+ * </p>
+ * <p>
+ * The annotation value should be one or several of
+ * {@link android.view.KeyEvent} constant fields which name contains KEYCODE. If
+ * not set, the method name will be used as the {@link android.view.KeyEvent}
+ * .KEYCODE_* field name.
+ * </p>
+ * <p>
+ * The method may return a <code>boolean</code>, <code>void</code>, or a
+ * {@link Boolean}. If returning void, it will be considered as
+ * returning true (ie: the method has handled the event).
+ * </p>
+ * <p>
+ * The method MAY have one parameter:
+ * </p>
+ * <ul>
+ * <li>A {@link android.view.KeyEvent} parameter to know which key has been down
+ * </li>
+ * </ul>
+ *
+ * <p>
+ * Example :
+ * </p>
+ *
+ * <pre>
+ * &#064;EActivity
+ * public class MyActivity extends Activity {
+ *
+ * 	&#064;KeyLongPress
+ * 	void enter() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyLongPress
+ * 	void onEnter() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyLongPress
+ * 	void onEnterPressed() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyLongPress
+ * 	void enterPressed() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyLongPress(KeyEvent.KEYCODE_0)
+ * 	void keyZeroIsLongPressed(KeyEvent keyEvent) {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyLongPress({ KeyEvent.KEYCODE_M, KeyEvent.KEYCODE_N })
+ * 	boolean multipleKeys(KeyEvent keyEvent) {
+ * 		return false;
+ * 	}
+ * }
+ * </pre>
+ *
+ * @see android.view.KeyEvent
+ * @see android.view.KeyEvent.Callback
+ * @see android.view.KeyEvent.Callback#onKeyLongPress(int, android.view.KeyEvent)
+ */
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.METHOD)
+public @interface KeyLongPress {
+
+	/**
+	 * The {@link android.view.KeyEvent} class constants which name contains
+	 * KEYCODE.
+	 *
+	 * @return the value of the key code
+	 */
+	int[] value() default {};
+}
diff --git a/.../androidannotations-api/src/main/java/org/androidannotations/annotations/KeyMultiple.java b/.../androidannotations-api/src/main/java/org/androidannotations/annotations/KeyMultiple.java
@@ -0,0 +1,105 @@
+/**
+ * Copyright (C) 2010-2015 eBusiness Information, Excilys Group
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this 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 org.androidannotations.annotations;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * <p>
+ * This annotation is intended to be used on methods to receive action multiple
+ * event on a key. This annotation can be used on methods of classes which
+ * implements {@link android.view.KeyEvent.Callback}.
+ * </p>
+ * <p>
+ * The annotation value should be one or several of
+ * {@link android.view.KeyEvent} constant fields which name contains KEYCODE. If
+ * not set, the method name will be used as the {@link android.view.KeyEvent}
+ * .KEYCODE_* field name.
+ * </p>
+ * <p>
+ * The method may return a <code>boolean</code>, <code>void</code>, or a
+ * {@link Boolean}. If returning void, it will be considered as
+ * returning true (ie: the method has handled the event).
+ * </p>
+ * <p>
+ * The method MAY have one or two parameter:
+ * </p>
+ * <ul>
+ * <li>A {@link android.view.KeyEvent} parameter to know which key has been down
+ * </li>
+ * <li>A <code>int</code> or {@link Integer} paramter to know the key is how
+ * many times repeated</li>
+ * </ul>
+ *
+ * <p>
+ * Example :
+ * </p>
+ *
+ * <pre>
+ * &#064;EActivity
+ * public class MyActivity extends Activity {
+ *
+ * 	&#064;KeyMultiple
+ * 	void enter() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyMultiple
+ * 	void onEnter() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyMultiple
+ * 	void onEnterPressed() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyMultiple
+ * 	void enterPressed() {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyMultiple(KeyEvent.KEYCODE_0)
+ * 	void keyZeroMultiple(KeyEvent keyEvent) {
+ * 		// ...
+ * 	}
+ *
+ * 	&#064;KeyMultiple({ KeyEvent.KEYCODE_M, KeyEvent.KEYCODE_N })
+ * 	boolean multipleKeys(KeyEvent keyEvent) {
+ * 		return false;
+ * 	}
+ * }
+ * </pre>
+ *
+ * @see android.view.KeyEvent
+ * @see android.view.KeyEvent.Callback
+ * @see android.view.KeyEvent.Callback#onKeyMultiple(int, int, android.view.KeyEvent)
+ */
+@Retention(RetentionPolicy.CLASS)
+@Target(ElementType.METHOD)
+public @interface KeyMultiple {
+
+	/**
+	 * The {@link android.view.KeyEvent} class constants which name contains
+	 * KEYCODE.
+	 *
+	 * @return the value of the key code
+	 */
+	int[] value() default {};
+}