toplevel_tracker.h File Reference

#include "toolkit/toolkit.h"
#include <libbase/libbase.h>
#include <stdbool.h>

Include dependency graph for toplevel_tracker.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
struct wlmaker_toplevel_tracker *	wlmaker_toplevel_tracker_create (struct wl_display *wl_display_ptr)
struct wlmaker_toplevel_tracker_handle *	wlmaker_toplevel_tracker_handle_create (struct wlmaker_toplevel_tracker *toplevel_tracker_ptr, wlmtk_window_t *window_ptr)
void	wlmaker_toplevel_tracker_handle_destroy (struct wlmaker_toplevel_tracker_handle *handle_ptr)
bool	wlmaker_toplevel_tracker_handle_set_title (struct wlmaker_toplevel_tracker_handle *handle_ptr, const char *title_ptr)
bool	wlmaker_toplevel_tracker_handle_set_app_id (struct wlmaker_toplevel_tracker_handle *handle_ptr, const char *title_ptr)

Variables
const bs_test_set_t	wlmaker_toplevel_tracker_test_set

Detailed Description

Methods to maintain the set of all registered toplevels, so the compositor can share the inofrmation with clients, such as a dock.

Copyright

Copyright (c) 2026 Philipp Kaeser kaese.nosp@m.r@gu.nosp@m.bbe.c.nosp@m.h

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

https://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.

Function Documentation

wlmaker_toplevel_tracker_create()

struct wlmaker_toplevel_tracker * wlmaker_toplevel_tracker_create

(

struct wl_display *

wl_display_ptr

)

Creates a toplevel tracker.

Parameters

wl_display_ptr

Returns

The toplevel tracker handle, or NULL on error. The toplevel tracker will be automatically destroyed when wl_display_ptr is destroyed.

wlmaker_toplevel_tracker_handle_create()

struct wlmaker_toplevel_tracker_handle * wlmaker_toplevel_tracker_handle_create	(	struct wlmaker_toplevel_tracker *	toplevel_tracker_ptr,
		wlmtk_window_t *	window_ptr
	)

Creates a toplevel handle.

Parameters

toplevel_tracker_ptr
window_ptr

Returns

The toplevel handle, or NULL on error.

wlmaker_toplevel_tracker_handle_destroy()

void wlmaker_toplevel_tracker_handle_destroy

(

struct wlmaker_toplevel_tracker_handle *

handle_ptr

)

Destroys the toplevel handle.

Parameters

handle_ptr

wlmaker_toplevel_tracker_handle_set_app_id()

bool wlmaker_toplevel_tracker_handle_set_app_id	(	struct wlmaker_toplevel_tracker_handle *	handle_ptr,
		const char *	title_ptr
	)

Sets the app ID for this toplevel.

wlmaker_toplevel_tracker_handle_set_title()

bool wlmaker_toplevel_tracker_handle_set_title	(	struct wlmaker_toplevel_tracker_handle *	handle_ptr,
		const char *	title_ptr
	)

Sets the title for this toplevel.

Variable Documentation

wlmaker_toplevel_tracker_test_set

const bs_test_set_t wlmaker_toplevel_tracker_test_set

extern

Toplevel tracker test set.