///

/// Base structure.

///

cef_panel_t base;

///

/// Show the Window.

///

void(CEF_CALLBACK* show)(struct _cef_window_t* self);

///

/// Show the Window as a browser modal dialog relative to |browser_view|. A

/// parent Window must be returned via

/// cef_window_delegate_t::get_parent_window() and |browser_view| must belong

/// to that parent Window. While this Window is visible, |browser_view| will

/// be disabled while other controls in the parent Window remain enabled.

/// Navigating or destroying the |browser_view| will close this Window

/// automatically. Alternately, use show() and return true (1) from

/// cef_window_delegate_t::is_window_modal_dialog() for a window modal dialog

/// where all controls in the parent Window are disabled.

///

void(CEF_CALLBACK* show_as_browser_modal_dialog)(

struct _cef_window_t* self,

struct _cef_browser_view_t* browser_view);

///

/// Hide the Window.

///

void(CEF_CALLBACK* hide)(struct _cef_window_t* self);

///

/// Sizes the Window to |size| and centers it in the current display.

///

void(CEF_CALLBACK* center_window)(struct _cef_window_t* self,

const cef_size_t* size);

///

/// Close the Window.

///

void(CEF_CALLBACK* close)(struct _cef_window_t* self);

///

/// Returns true (1) if the Window has been closed.

///

int(CEF_CALLBACK* is_closed)(struct _cef_window_t* self);

///

/// Activate the Window, assuming it already exists and is visible.

///

void(CEF_CALLBACK* activate)(struct _cef_window_t* self);

///

/// Deactivate the Window, making the next Window in the Z order the active

/// Window.

///

void(CEF_CALLBACK* deactivate)(struct _cef_window_t* self);

///

/// Returns whether the Window is the currently active Window.

///

int(CEF_CALLBACK* is_active)(struct _cef_window_t* self);

///

/// Bring this Window to the top of other Windows in the Windowing system.

///

void(CEF_CALLBACK* bring_to_top)(struct _cef_window_t* self);

///

/// Set the Window to be on top of other Windows in the Windowing system.

///

void(CEF_CALLBACK* set_always_on_top)(struct _cef_window_t* self, int on_top);

///

/// Returns whether the Window has been set to be on top of other Windows in

/// the Windowing system.

///

int(CEF_CALLBACK* is_always_on_top)(struct _cef_window_t* self);

///

/// Maximize the Window.

///

void(CEF_CALLBACK* maximize)(struct _cef_window_t* self);

///

/// Minimize the Window.

///

void(CEF_CALLBACK* minimize)(struct _cef_window_t* self);

///

/// Restore the Window.

///

void(CEF_CALLBACK* restore)(struct _cef_window_t* self);

///

/// Set fullscreen Window state. The

/// cef_window_delegate_t::OnWindowFullscreenTransition function will be

/// called during the fullscreen transition for notification purposes.

///

void(CEF_CALLBACK* set_fullscreen)(struct _cef_window_t* self,

int fullscreen);

///

/// Returns true (1) if the Window is maximized.

///

int(CEF_CALLBACK* is_maximized)(struct _cef_window_t* self);

///

/// Returns true (1) if the Window is minimized.

///

int(CEF_CALLBACK* is_minimized)(struct _cef_window_t* self);

///

/// Returns true (1) if the Window is fullscreen.

///

int(CEF_CALLBACK* is_fullscreen)(struct _cef_window_t* self);

///

/// Set the Window title.

///

void(CEF_CALLBACK* set_title)(struct _cef_window_t* self,

const cef_string_t* title);

///

/// Get the Window title.

///

// The resulting string must be freed by calling cef_string_userfree_free().

cef_string_userfree_t(CEF_CALLBACK* get_title)(struct _cef_window_t* self);

///

/// Set the Window icon. This should be a 16x16 icon suitable for use in the

/// Windows's title bar.

///

void(CEF_CALLBACK* set_window_icon)(struct _cef_window_t* self,

struct _cef_image_t* image);

///

/// Get the Window icon.

///

struct _cef_image_t*(CEF_CALLBACK* get_window_icon)(

struct _cef_window_t* self);

///

/// Set the Window App icon. This should be a larger icon for use in the host

/// environment app switching UI. On Windows, this is the ICON_BIG used in

/// Alt-Tab list and Windows taskbar. The Window icon will be used by default

/// if no Window App icon is specified.

///

void(CEF_CALLBACK* set_window_app_icon)(struct _cef_window_t* self,

struct _cef_image_t* image);

///

/// Get the Window App icon.

///

struct _cef_image_t*(CEF_CALLBACK* get_window_app_icon)(

struct _cef_window_t* self);

///

/// Add a View that will be overlayed on the Window contents with absolute

/// positioning and high z-order. Positioning is controlled by |docking_mode|

/// as described below. Setting |can_activate| to true (1) will allow the

/// overlay view to receive input focus. The returned cef_overlay_controller_t

/// object is used to control the overlay. Overlays are hidden by default.

///

/// With CEF_DOCKING_MODE_CUSTOM:

/// 1. The overlay is initially hidden, sized to |view|'s preferred size,

/// and positioned in the top-left corner.

/// 2. Optionally change the overlay position and/or size by calling

/// CefOverlayController methods.

/// 3. Call CefOverlayController::SetVisible(true) to show the overlay.

/// 4. The overlay will be automatically re-sized if |view|'s layout

/// changes. Optionally change the overlay position and/or size when

/// OnLayoutChanged is called on the Window's delegate to indicate a

/// change in Window bounds.

///

/// With other docking modes:

/// 1. The overlay is initially hidden, sized to |view|'s preferred size,

/// and positioned based on |docking_mode|.

/// 2. Call CefOverlayController::SetVisible(true) to show the overlay.

/// 3. The overlay will be automatically re-sized if |view|'s layout changes

/// and re-positioned as appropriate when the Window resizes.

///

/// Overlays created by this function will receive a higher z-order then any

/// child Views added previously. It is therefore recommended to call this

/// function last after all other child Views have been added so that the

/// overlay displays as the top-most child of the Window.

///

struct _cef_overlay_controller_t*(CEF_CALLBACK* add_overlay_view)(

struct _cef_window_t* self,

struct _cef_view_t* view,

cef_docking_mode_t docking_mode,

int can_activate);

///

/// Show a menu with contents |menu_model|. |screen_point| specifies the menu

/// position in screen coordinates. |anchor_position| specifies how the menu

/// will be anchored relative to |screen_point|.

///

void(CEF_CALLBACK* show_menu)(struct _cef_window_t* self,

struct _cef_menu_model_t* menu_model,

const cef_point_t* screen_point,

cef_menu_anchor_position_t anchor_position);

///

/// Cancel the menu that is currently showing, if any.

///

void(CEF_CALLBACK* cancel_menu)(struct _cef_window_t* self);

///

/// Returns the Display that most closely intersects the bounds of this

/// Window. May return NULL if this Window is not currently displayed.

///

struct _cef_display_t*(CEF_CALLBACK* get_display)(struct _cef_window_t* self);

///

/// Returns the bounds (size and position) of this Window's client area.

/// Position is in screen coordinates.

///

cef_rect_t(CEF_CALLBACK* get_client_area_bounds_in_screen)(

struct _cef_window_t* self);

///

/// Set the regions where mouse events will be intercepted by this Window to

/// support drag operations. Call this function with an NULL vector to clear

/// the draggable regions. The draggable region bounds should be in window

/// coordinates.

///

void(CEF_CALLBACK* set_draggable_regions)(

struct _cef_window_t* self,

size_t regionsCount,

cef_draggable_region_t const* regions);

///

/// Retrieve the platform window handle for this Window.

///

cef_window_handle_t(CEF_CALLBACK* get_window_handle)(

struct _cef_window_t* self);

///

/// Simulate a key press. |key_code| is the VKEY_* value from Chromium's

/// ui/events/keycodes/keyboard_codes.h header (VK_* values on Windows).

/// |event_flags| is some combination of EVENTFLAG_SHIFT_DOWN,

/// EVENTFLAG_CONTROL_DOWN and/or EVENTFLAG_ALT_DOWN. This function is exposed

/// primarily for testing purposes.

///

void(CEF_CALLBACK* send_key_press)(struct _cef_window_t* self,

int key_code,

uint32_t event_flags);

///

/// Simulate a mouse move. The mouse cursor will be moved to the specified

/// (screen_x, screen_y) position. This function is exposed primarily for

/// testing purposes.

///

void(CEF_CALLBACK* send_mouse_move)(struct _cef_window_t* self,

int screen_x,

int screen_y);

///

/// Simulate mouse down and/or mouse up events. |button| is the mouse button

/// type. If |mouse_down| is true (1) a mouse down event will be sent. If

/// |mouse_up| is true (1) a mouse up event will be sent. If both are true (1)

/// a mouse down event will be sent followed by a mouse up event (equivalent

/// to clicking the mouse button). The events will be sent using the current

/// cursor position so make sure to call send_mouse_move() first to position

/// the mouse. This function is exposed primarily for testing purposes.

///

void(CEF_CALLBACK* send_mouse_events)(struct _cef_window_t* self,

cef_mouse_button_type_t button,

int mouse_down,

int mouse_up);

///

/// Set the keyboard accelerator for the specified |command_id|. |key_code|

/// can be any virtual key or character value. Required modifier keys are

/// specified by |shift_pressed|, |ctrl_pressed| and/or |alt_pressed|.

/// cef_window_delegate_t::OnAccelerator will be called if the keyboard

/// combination is triggered while this window has focus.

///

/// The |high_priority| value will be considered if a child cef_browser_view_t

/// has focus when the keyboard combination is triggered. If |high_priority|

/// is true (1) then the key event will not be forwarded to the web content

/// (`keydown` event handler) or cef_keyboard_handler_t first. If

/// |high_priority| is false (0) then the behavior will depend on the

/// cef_browser_view_t::SetPreferAccelerators configuration.

///

void(CEF_CALLBACK* set_accelerator)(struct _cef_window_t* self,

int command_id,

int key_code,

int shift_pressed,

int ctrl_pressed,

int alt_pressed,

int high_priority);

///

/// Remove the keyboard accelerator for the specified |command_id|.

///

void(CEF_CALLBACK* remove_accelerator)(struct _cef_window_t* self,

int command_id);

///

/// Remove all keyboard accelerators.

///

void(CEF_CALLBACK* remove_all_accelerators)(struct _cef_window_t* self);

///

/// Override a standard theme color or add a custom color associated with

/// |color_id|. See cef_color_ids.h for standard ID values. Recommended usage

/// is as follows:

///

/// 1. Customize the default native/OS theme by calling SetThemeColor before

/// showing the first Window. When done setting colors call

/// CefWindow::ThemeChanged to trigger CefViewDelegate::OnThemeChanged

/// notifications.

/// 2. Customize the current native/OS or Chrome theme after it changes by

/// calling SetThemeColor from the CefWindowDelegate::OnThemeColorsChanged

/// callback. CefViewDelegate::OnThemeChanged notifications will then be

/// triggered automatically.

///

/// The configured color will be available immediately via

/// cef_view_t::GetThemeColor and will be applied to each View in this

/// Window's component hierarchy when cef_view_delegate_t::OnThemeChanged is

/// called. See OnThemeColorsChanged documentation for additional details.

///

/// Clients wishing to add custom colors should use |color_id| values >=

/// CEF_ChromeColorsEnd.

///

void(CEF_CALLBACK* set_theme_color)(struct _cef_window_t* self,

int color_id,

cef_color_t color);

///

/// Trigger cef_view_delegate_t::OnThemeChanged callbacks for each View in

/// this Window's component hierarchy. Unlike a native/OS or Chrome theme

/// change this function does not reset theme colors to standard values and

/// does not result in a call to cef_window_delegate_t::OnThemeColorsChanged.

///

/// Do not call this function from cef_window_delegate_t::OnThemeColorsChanged

/// or cef_view_delegate_t::OnThemeChanged.

///

void(CEF_CALLBACK* theme_changed)(struct _cef_window_t* self);

///

/// Returns the runtime style for this Window (ALLOY or CHROME). See

/// cef_runtime_style_t documentation for details.

///

cef_runtime_style_t(CEF_CALLBACK* get_runtime_style)(

struct _cef_window_t* self);