rename_window


Description:

public void rename_window (Window window, string new_name)

Asks the session manager to rename window's stored state name to new_name.

window must be registered with the compositor via a previous call to xfce_session_client_add_window() or xfce_session_client_restore_window().

new_name must be unique, and cannot be a string that has previously been sent to the session manager using xfce_session_client_add_window(), xfce_session_client_restore_window(), or this function. If you wish to re-use new_name, you must call xfce_session_client_remove_window() first.

Note that if this function is called while window is not mapped or client is not connected, the actual rename operation will be deferred until the next time it is mapped when client is connected.

If another window is named new_name, but is unmapped with a pending rename to another name, it is an error to call this function with new_name on window. You must first map the other window so the rename away from new_name can complete.

Parameters:

this

An SessionClient

window

A Window

new_name

A unique name