kde_screen_edge_v1

• # kde_screen_edge_manager_v1

  This interface allows clients to associate actions with screen edges. For example, showing a surface by moving the pointer to a screen edge. Potential ways to trigger the screen edge are subject to compositor policies. As an example, the compositor may consider the screen edge to be triggered if the pointer hits its associated screen border. Other ways may include using touchscreen or touchpad gestures. Warning! The protocol described in this file is a desktop environment implementation detail. Regular clients must not use this protocol. Backward incompatible changes may be added without bumping the major version of the extension.

  Requests

  • #

    destroy

    destroy the screen edge manager
    void kde_screen_edge_manager_v1_destroy(

    struct kde_screen_edge_manager_v1* kde_screen_edge_manager_v1

    )
    Destroy the screen edge manager. This doesn't destroy objects created with this manager.
  • #

    get_auto_hide_screen_edge

    create an auto hide edge
    struct kde_auto_hide_screen_edge_v1* kde_screen_edge_manager_v1_get_auto_hide_screen_edge(

    struct kde_screen_edge_manager_v1* kde_screen_edge_manager_v1,

    uint32_t border, /* the associated screen border */

    struct wl_surface* surface /* the surface */

    )
    Create a new auto hide screen edge object associated with the specified surface and the border. Creating a kde_auto_hide_screen_edge_v1 object does not change the visibility of the surface. The kde_auto_hide_screen_edge_v1.activate request must be issued in order to hide the surface. The "border" argument must be a valid enum entry, otherwise the invalid_border protocol error is raised. The invalid_role protocol error will be raised if the specified surface does not have layer_surface role.

  Enums

  • #

    error
    KDE_SCREEN_EDGE_MANAGER_V1_ERROR_INVALID_BORDER /* the specified border value is invalid */
    KDE_SCREEN_EDGE_MANAGER_V1_ERROR_INVALID_ROLE /* the surface has invalid role */
    KDE_SCREEN_EDGE_MANAGER_V1_ERROR_ALREADY_CONSTRUCTED /* the surface already has a screen edge */
  • #

    border

    screen border
    KDE_SCREEN_EDGE_MANAGER_V1_BORDER_TOP /* top screen edge */
    KDE_SCREEN_EDGE_MANAGER_V1_BORDER_BOTTOM /* bottom screen edge */
    KDE_SCREEN_EDGE_MANAGER_V1_BORDER_LEFT /* left screen edge */
    KDE_SCREEN_EDGE_MANAGER_V1_BORDER_RIGHT /* right screen edge */
    These values describe possible screen borders.

• # kde_auto_hide_screen_edge_v1

  The auto hide screen edge object allows to hide the surface and make it visible by triggering the screen edge. The screen edge is inactive and the surface is visible by default. This interface can be used to implement user interface elements such as auto-hide panels or docks. kde_auto_hide_screen_edge_v1.activate activates the screen edge and makes the surface hidden. The surface can be made visible by triggering the screen edge or calling kde_auto_hide_screen_edge_v1.deactivate. If the screen edge has been triggered, it won't be re-activated again. Another kde_auto_hide_screen_edge_v1.activate request must be made by the client to activate the screen edge.

  Requests

  • #

    destroy

    destroy the auto hide screen edge object
    void kde_auto_hide_screen_edge_v1_destroy(

    struct kde_auto_hide_screen_edge_v1* kde_auto_hide_screen_edge_v1

    )
    Destroy the auto hide screen edge object. If the screen edge is active, it will be deactivated and the surface will be made visible.
  • #

    deactivate

    deactivate the screen edge
    void kde_auto_hide_screen_edge_v1_deactivate(

    struct kde_auto_hide_screen_edge_v1* kde_auto_hide_screen_edge_v1

    )
    Deactivate the screen edge. The surface will be made visible.
  • #

    activate

    activate the screen edge
    void kde_auto_hide_screen_edge_v1_activate(

    struct kde_auto_hide_screen_edge_v1* kde_auto_hide_screen_edge_v1

    )
    Activate the screen edge. The surface will be hidden until the screen edge is triggered.

Copyright Info