wlr_foreign_toplevel_management_unstable_v1

# zwlr_foreign_toplevel_manager_v1

The purpose of this protocol is to enable the creation of taskbars and docks by providing them with a list of opened applications and letting them request certain actions on them, like maximizing, etc. After a client binds the zwlr_foreign_toplevel_manager_v1, each opened toplevel window will be sent via the toplevel event

Requests
- #
  stop
  
  stop sending events
  
  void zwlr_foreign_toplevel_manager_v1_stop(
  struct zwlr_foreign_toplevel_manager_v1* zwlr_foreign_toplevel_manager_v1
  )
  
  Indicates the client no longer wishes to receive events for new toplevels. However the compositor may emit further toplevel_created events, until the finished event is emitted. The client must not send any more requests after this one.
Events
- #
  toplevel
  
  a toplevel has been created
  
  struct zwlr_foreign_toplevel_handle_v1* toplevel
  
  This event is emitted whenever a new toplevel window is created. It is emitted for all toplevels, regardless of the app that has created them. All initial details of the toplevel(title, app_id, states, etc.) will be sent immediately after this event via the corresponding events in zwlr_foreign_toplevel_handle_v1.
- #
  finished
  
  the compositor has finished with the toplevel manager
  
  This event indicates that the compositor is done sending events to the zwlr_foreign_toplevel_manager_v1. The server will destroy the object immediately after sending this request, so it will become invalid and the client should free any resources associated with it.
# zwlr_foreign_toplevel_handle_v1

A zwlr_foreign_toplevel_handle_v1 object represents an opened toplevel window. Each app may have multiple opened toplevels. Each toplevel has a list of outputs it is visible on, conveyed to the client with the output_enter and output_leave events.

Requests
- #
  set_maximized
  
  requests that the toplevel be maximized
  
  void zwlr_foreign_toplevel_handle_v1_set_maximized(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1
  )
  
  Requests that the toplevel be maximized. If the maximized state actually changes, this will be indicated by the state event.
- #
  unset_maximized
  
  requests that the toplevel be unmaximized
  
  void zwlr_foreign_toplevel_handle_v1_unset_maximized(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1
  )
  
  Requests that the toplevel be unmaximized. If the maximized state actually changes, this will be indicated by the state event.
- #
  set_minimized
  
  requests that the toplevel be minimized
  
  void zwlr_foreign_toplevel_handle_v1_set_minimized(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1
  )
  
  Requests that the toplevel be minimized. If the minimized state actually changes, this will be indicated by the state event.
- #
  unset_minimized
  
  requests that the toplevel be unminimized
  
  void zwlr_foreign_toplevel_handle_v1_unset_minimized(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1
  )
  
  Requests that the toplevel be unminimized. If the minimized state actually changes, this will be indicated by the state event.
- #
  activate
  
  activate the toplevel
  
  void zwlr_foreign_toplevel_handle_v1_activate(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1,
  
  struct wl_seat* seat
  )
  
  Request that this toplevel be activated on the given seat. There is no guarantee the toplevel will be actually activated.
- #
  close
  
  request that the toplevel be closed
  
  void zwlr_foreign_toplevel_handle_v1_close(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1
  )
  
  Send a request to the toplevel to close itself. The compositor would typically use a shell-specific method to carry out this request, for example by sending the xdg_toplevel.close event. However, this gives no guarantees the toplevel will actually be destroyed. If and when this happens, the zwlr_foreign_toplevel_handle_v1.closed event will be emitted.
- #
  set_rectangle
  
  the rectangle which represents the toplevel
  
  void zwlr_foreign_toplevel_handle_v1_set_rectangle(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1,
  
  struct wl_surface* surface,
  
  int32_t x,
  
  int32_t y,
  
  int32_t width,
  
  int32_t height
  )
  
  The rectangle of the surface specified in this request corresponds to the place where the app using this protocol represents the given toplevel. It can be used by the compositor as a hint for some operations, e.g minimizing. The client is however not required to set this, in which case the compositor is free to decide some default value. If the client specifies more than one rectangle, only the last one is considered. The dimensions are given in surface-local coordinates. Setting width=height=0 removes the already-set rectangle.
- #
  destroy
  
  destroy the zwlr_foreign_toplevel_handle_v1 object
  
  void zwlr_foreign_toplevel_handle_v1_destroy(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1
  )
  
  Destroys the zwlr_foreign_toplevel_handle_v1 object. This request should be called either when the client does not want to use the toplevel anymore or after the closed event to finalize the destruction of the object.
- #
  set_fullscreen
  
  request that the toplevel be fullscreened
  
  void zwlr_foreign_toplevel_handle_v1_set_fullscreen(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1,
  
  struct wl_output* output
  )
  
  Requests that the toplevel be fullscreened on the given output. If the fullscreen state and/or the outputs the toplevel is visible on actually change, this will be indicated by the state and output_enter/leave events. The output parameter is only a hint to the compositor. Also, if output is NULL, the compositor should decide which output the toplevel will be fullscreened on, if at all.
- #
  unset_fullscreen
  
  request that the toplevel be unfullscreened
  
  void zwlr_foreign_toplevel_handle_v1_unset_fullscreen(
  struct zwlr_foreign_toplevel_handle_v1* zwlr_foreign_toplevel_handle_v1
  )
  
  Requests that the toplevel be unfullscreened. If the fullscreen state actually changes, this will be indicated by the state event.
Events
- #
  title
  
  title change
  
  const char* title
  
  This event is emitted whenever the title of the toplevel changes.
- #
  app_id
  
  app-id change
  
  const char* app_id
  
  This event is emitted whenever the app-id of the toplevel changes.
- #
  output_enter
  
  toplevel entered an output
  
  struct wl_output* output
  
  This event is emitted whenever the toplevel becomes visible on the given output. A toplevel may be visible on multiple outputs.
- #
  output_leave
  
  toplevel left an output
  
  struct wl_output* output
  
  This event is emitted whenever the toplevel stops being visible on the given output. It is guaranteed that an entered-output event with the same output has been emitted before this event.
- #
  state
  
  the toplevel state changed
  
  struct wl_array* state
  
  This event is emitted immediately after the zlw_foreign_toplevel_handle_v1 is created and each time the toplevel state changes, either because of a compositor action or because of a request in this protocol.
- #
  done
  
  all information about the toplevel has been sent
  
  This event is sent after all changes in the toplevel state have been sent. This allows changes to the zwlr_foreign_toplevel_handle_v1 properties to be seen as atomic, even if they happen via multiple events.
- #
  closed
  
  this toplevel has been destroyed
  
  This event means the toplevel has been destroyed. It is guaranteed there won't be any more events for this zwlr_foreign_toplevel_handle_v1. The toplevel itself becomes inert so any requests will be ignored except the destroy request.
- #
  parent
  
  parent change
  
  struct zwlr_foreign_toplevel_handle_v1* parent
  
  This event is emitted whenever the parent of the toplevel changes. No event is emitted when the parent handle is destroyed by the client.
Enums
- #
  state
  
  types of states on the toplevel
  
  ZWLR_FOREIGN_TOPLEVEL_HANDLE_V1_STATE_MAXIMIZED /* the toplevel is maximized */
  
  ZWLR_FOREIGN_TOPLEVEL_HANDLE_V1_STATE_MINIMIZED /* the toplevel is minimized */
  
  ZWLR_FOREIGN_TOPLEVEL_HANDLE_V1_STATE_ACTIVATED /* the toplevel is active */
  
  ZWLR_FOREIGN_TOPLEVEL_HANDLE_V1_STATE_FULLSCREEN /* the toplevel is fullscreen */
  
  The different states that a toplevel can have. These have the same meaning as the states with the same names defined in xdg-toplevel
- #
  error
  
  ZWLR_FOREIGN_TOPLEVEL_HANDLE_V1_ERROR_INVALID_RECTANGLE /* the provided rectangle is invalid */

Copyright Info

Copyright © 2018 Ilia Bozhinov Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of the copyright holders not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. The copyright holders make no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

wlr_foreign_toplevel_management_unstable_v1

# zwlr_foreign_toplevel_manager_v1

Requests

Events

# zwlr_foreign_toplevel_handle_v1

Requests

Events

Enums

Copyright Info