2016-02-03 11:00 GMT+02:00 Jasper St. Pierre <jstpie...@mecheye.net>: > No? The parent is the surface the tooltip is laid on top of.
So where do the contents of the tooltip come from? > > On Wed, Feb 3, 2016 at 12:59 AM, Giulio Camuffo <giuliocamu...@gmail.com> > wrote: >> 2016-02-03 10:39 GMT+02:00 Jonas Ådahl <jad...@gmail.com>: >>> An xdg_tooltip is a new window type used to implement tooltip like >>> surfaces. See the interface documentation for details. >>> >>> Signed-off-by: Jonas Ådahl <jad...@gmail.com> >>> --- >>> >>> Changes since v1: >>> >>> Various wording changes as suggested by Mike. >>> >>> Added missing version attribute and <description/>. >>> >>> >>> unstable/xdg-shell/xdg-shell-unstable-v6.xml | 41 >>> ++++++++++++++++++++++++++++ >>> 1 file changed, 41 insertions(+) >>> >>> diff --git a/unstable/xdg-shell/xdg-shell-unstable-v6.xml >>> b/unstable/xdg-shell/xdg-shell-unstable-v6.xml >>> index f2eba64..a164bd6 100644 >>> --- a/unstable/xdg-shell/xdg-shell-unstable-v6.xml >>> +++ b/unstable/xdg-shell/xdg-shell-unstable-v6.xml >>> @@ -168,6 +168,20 @@ >>> <arg name="y" type="int"/> >>> </request> >>> >>> + <request name="get_tooltip"> >>> + <description summary="assign the xdg_tooltip surface role"> >>> + This creates an xdg_tooltip for the given xdg_surface and gives the >>> + associated wl_surface the xdg_tooltip role. >>> + >>> + See the documentation of xdg_tooltip for more details about what an >>> + xdg_tooltip is and how it is used. >>> + </description> >>> + <arg name="id" type="new_id" interface="zxdg_tooltip_v6"/> >>> + <arg name="parent" type="object" interface="zxdg_surface_v6"/> >>> + <arg name="x" type="int"/> >>> + <arg name="y" type="int"/> >>> + </request> >> >> Hi, I have just a comment here: >> >> I understand that 'parent' here is the actual tooltip surface, right? >> The description of the zxdg_tooltip_v6 interface below uses parent to >> refer to another surface, and that's i suppose the surface set with >> xdg_surface.set_parent(), right? I find that confusing, i would rename >> 'parent' in get_tooltip to 'surface', and maybe clarify in the >> description what is the actual parent. >> >> >> Cheers, >> Giulio >> >> >>> + >>> <request name="set_window_geometry"> >>> <description summary="set the new window geometry"> >>> The window geometry of a surface is its "visible bounds" from the >>> @@ -650,4 +664,31 @@ >>> >>> </interface> >>> >>> + <interface name="zxdg_tooltip_v6" version="1"> >>> + <description summary="tooltip surface"> >>> + This interface defines an xdg_tooltip role that provides >>> functionality >>> + related to tooltip like surfaces. >>> + >>> + An xdg_tooltip is a temporary surface which is displayed over its >>> parent >>> + xdg_surface. The last-created xdg_tooltip surface will always be the >>> + top-most child of the parent xdg_surface. >>> + >>> + The parent surface must either have the surface role xdg_toplevel, >>> + xdg_popup or xdg_tooltip. >>> + >>> + An xdg_tooltip does not take an active grab while mapped. xdg_tooltip >>> + surfaces are either directly unmapped by clients using the >>> + xdg_tooltip.destroy request or indirectly unmapped when their parent >>> + surface is unmapped. >>> + >>> + An xdg_tooltip obeys normal input region semantics. >>> + </description> >>> + >>> + <request name="destroy" type="destructor"> >>> + <description summary="destroy the xdg_tooltip object"> >>> + Unmap the tooltip surface and destroy the object. >>> + </description> >>> + </request> >>> + </interface> >>> + >>> </protocol> >>> -- >>> 2.4.3 >>> >>> _______________________________________________ >>> wayland-devel mailing list >>> wayland-devel@lists.freedesktop.org >>> http://lists.freedesktop.org/mailman/listinfo/wayland-devel > > > > -- > Jasper _______________________________________________ wayland-devel mailing list wayland-devel@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/wayland-devel