From f842b59caa0b98c0c0e229ecb9f7c615650e50e8 Mon Sep 17 00:00:00 2001 From: Sven Gothel Date: Sun, 27 Nov 2011 17:24:29 +0100 Subject: NEWT: Add DriverUpdatePosition interface; Clarify NativeWindow API doc (position) DriverUpdatePosition: Interface tagging driver requirement of absolute positioning, ie. depend on parent position. --- .../classes/javax/media/nativewindow/NativeWindow.java | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) (limited to 'src/nativewindow/classes/javax/media') diff --git a/src/nativewindow/classes/javax/media/nativewindow/NativeWindow.java b/src/nativewindow/classes/javax/media/nativewindow/NativeWindow.java index e3ee85cf4..2bc352116 100644 --- a/src/nativewindow/classes/javax/media/nativewindow/NativeWindow.java +++ b/src/nativewindow/classes/javax/media/nativewindow/NativeWindow.java @@ -104,20 +104,26 @@ public interface NativeWindow extends NativeSurface { /** * @return the current x position of the top-left corner - * of the client area, hence excluding insets (window decorations).
+ * of the client area relative to it's parent. + * Since the position reflects the client area, it does not include the insets. * @see #getInsets() */ public int getX(); /** * @return the current y position of the top-left corner - * of the client area, hence excluding insets (window decorations).
+ * of the client area relative to it's parent. + * Since the position reflects the client area, it does not include the insets. * @see #getInsets() */ public int getY(); /** - * Returns the current absolute location of this window. + * Returns the current position of the top-left corner + * of the client area in screen coordinates. + *

+ * Since the position reflects the client area, it does not include the insets. + *

* @param point if not null, * {@link javax.media.nativewindow.util.Point#translate(javax.media.nativewindow.util.Point)} * the passed {@link javax.media.nativewindow.util.Point} by this location on the screen and return it. -- cgit v1.2.3