present_with_time


Description:

public void present_with_time (uint32 timestamp)

Presents a window to the user.

This may mean raising the window in the stacking order, unminimizing it, moving it to the current desktop, and/or giving it the keyboard focus, possibly dependent on the user’s platform, window manager, and preferences.

If this is hidden, this function calls show as well.

This function should be used when the user tries to open a window that’s already open. Say for example the preferences dialog is currently open, and the user chooses Preferences from the menu a second time; use present to move the already-open dialog where the user can see it.

Presents a window to the user in response to a user interaction. The timestamp should be gathered when the window was requested to be shown ( when clicking a link for example), rather than once the window is ready to be shown.

Parameters:

this

a Window

timestamp

the timestamp of the user interaction (typically a button or key press event) which triggered this call