public:

///

/// Returns this View as a BrowserView or NULL if this is not a BrowserView.

///

/*--cef()--*/

virtual CefRefPtr<CefBrowserView> AsBrowserView() = 0;

///

/// Returns this View as a Button or NULL if this is not a Button.

///

/*--cef()--*/

virtual CefRefPtr<CefButton> AsButton() = 0;

///

/// Returns this View as a Panel or NULL if this is not a Panel.

///

/*--cef()--*/

virtual CefRefPtr<CefPanel> AsPanel() = 0;

///

/// Returns this View as a ScrollView or NULL if this is not a ScrollView.

///

/*--cef()--*/

virtual CefRefPtr<CefScrollView> AsScrollView() = 0;

///

/// Returns this View as a Textfield or NULL if this is not a Textfield.

///

/*--cef()--*/

virtual CefRefPtr<CefTextfield> AsTextfield() = 0;

///

/// Returns the type of this View as a string. Used primarily for testing

/// purposes.

///

/*--cef()--*/

virtual CefString GetTypeString() = 0;

///

/// Returns a string representation of this View which includes the type and

/// various type-specific identifying attributes. If |include_children| is

/// true any child Views will also be included. Used primarily for testing

/// purposes.

///

/*--cef()--*/

virtual CefString ToString(bool include_children) = 0;

///

/// Returns true if this View is valid.

///

/*--cef()--*/

virtual bool IsValid() = 0;

///

/// Returns true if this View is currently attached to another View. A View

/// can only be attached to one View at a time.

///

/*--cef()--*/

virtual bool IsAttached() = 0;

///

/// Returns true if this View is the same as |that| View.

///

/*--cef()--*/

virtual bool IsSame(CefRefPtr<CefView> that) = 0;

///

/// Returns the delegate associated with this View, if any.

///

/*--cef()--*/

virtual CefRefPtr<CefViewDelegate> GetDelegate() = 0;

///

/// Returns the top-level Window hosting this View, if any.

///

/*--cef()--*/

virtual CefRefPtr<CefWindow> GetWindow() = 0;

///

/// Returns the ID for this View.

///

/*--cef()--*/

virtual int GetID() = 0;

///

/// Sets the ID for this View. ID should be unique within the subtree that you

/// intend to search for it. 0 is the default ID for views.

///

/*--cef()--*/

virtual void SetID(int id) = 0;

///

/// Returns the group id of this View, or -1 if not set.

///

/*--cef()--*/

virtual int GetGroupID() = 0;

///

/// A group id is used to tag Views which are part of the same logical group.

/// Focus can be moved between views with the same group using the arrow keys.

/// The group id is immutable once it's set.

///

/*--cef()--*/

virtual void SetGroupID(int group_id) = 0;

///

/// Returns the View that contains this View, if any.

///

/*--cef()--*/

virtual CefRefPtr<CefView> GetParentView() = 0;

///

/// Recursively descends the view tree starting at this View, and returns the

/// first child that it encounters with the given ID. Returns NULL if no

/// matching child view is found.

///

/*--cef()--*/

virtual CefRefPtr<CefView> GetViewForID(int id) = 0;

///

/// Sets the bounds (size and position) of this View. |bounds| is in parent

/// coordinates, or DIP screen coordinates if there is no parent.

///

/*--cef()--*/

virtual void SetBounds(const CefRect& bounds) = 0;

///

/// Returns the bounds (size and position) of this View in parent coordinates,

/// or DIP screen coordinates if there is no parent.

///

/*--cef()--*/

virtual CefRect GetBounds() = 0;

///

/// Returns the bounds (size and position) of this View in DIP screen

/// coordinates.

///

/*--cef()--*/

virtual CefRect GetBoundsInScreen() = 0;

///

/// Sets the size of this View without changing the position. |size| in

/// parent coordinates, or DIP screen coordinates if there is no parent.

///

/*--cef()--*/

virtual void SetSize(const CefSize& size) = 0;

///

/// Returns the size of this View in parent coordinates, or DIP screen

/// coordinates if there is no parent.

///

/*--cef()--*/

virtual CefSize GetSize() = 0;

///

/// Sets the position of this View without changing the size. |position| is in

/// parent coordinates, or DIP screen coordinates if there is no parent.

///

/*--cef()--*/

virtual void SetPosition(const CefPoint& position) = 0;

///

/// Returns the position of this View. Position is in parent coordinates, or

/// DIP screen coordinates if there is no parent.

///

/*--cef()--*/

virtual CefPoint GetPosition() = 0;

///

/// Sets the insets for this View. |insets| is in parent coordinates, or DIP

/// screen coordinates if there is no parent.

///

/*--cef()--*/

virtual void SetInsets(const CefInsets& insets) = 0;

///

/// Returns the insets for this View in parent coordinates, or DIP screen

/// coordinates if there is no parent.

///

/*--cef()--*/

virtual CefInsets GetInsets() = 0;

///

/// Returns the size this View would like to be if enough space is available.

/// Size is in parent coordinates, or DIP screen coordinates if there is no

/// parent.

///

/*--cef()--*/

virtual CefSize GetPreferredSize() = 0;

///

/// Size this View to its preferred size. Size is in parent coordinates, or

/// DIP screen coordinates if there is no parent.

///

/*--cef()--*/

virtual void SizeToPreferredSize() = 0;

///

/// Returns the minimum size for this View. Size is in parent coordinates, or

/// DIP screen coordinates if there is no parent.

///

/*--cef()--*/

virtual CefSize GetMinimumSize() = 0;

///

/// Returns the maximum size for this View. Size is in parent coordinates, or

/// DIP screen coordinates if there is no parent.

///

/*--cef()--*/

virtual CefSize GetMaximumSize() = 0;

///

/// Returns the height necessary to display this View with the provided width.

///

/*--cef()--*/

virtual int GetHeightForWidth(int width) = 0;

///

/// Indicate that this View and all parent Views require a re-layout. This

/// ensures the next call to Layout() will propagate to this View even if the

/// bounds of parent Views do not change.

///

/*--cef()--*/

virtual void InvalidateLayout() = 0;

///

/// Sets whether this View is visible. Windows are hidden by default and other

/// views are visible by default. This View and any parent views must be set

/// as visible for this View to be drawn in a Window. If this View is set as

/// hidden then it and any child views will not be drawn and, if any of those

/// views currently have focus, then focus will also be cleared. Painting is

/// scheduled as needed. If this View is a Window then calling this method is

/// equivalent to calling the Window Show() and Hide() methods.

///

/*--cef()--*/

virtual void SetVisible(bool visible) = 0;

///

/// Returns whether this View is visible. A view may be visible but still not

/// drawn in a Window if any parent views are hidden. If this View is a Window

/// then a return value of true indicates that this Window is currently

/// visible to the user on-screen. If this View is not a Window then call

/// IsDrawn() to determine whether this View and all parent views are visible

/// and will be drawn.

///

/*--cef()--*/

virtual bool IsVisible() = 0;

///

/// Returns whether this View is visible and drawn in a Window. A view is

/// drawn if it and all parent views are visible. If this View is a Window

/// then calling this method is equivalent to calling IsVisible(). Otherwise,

/// to determine if the containing Window is visible to the user on-screen

/// call IsVisible() on the Window.

///

/*--cef()--*/

virtual bool IsDrawn() = 0;

///

/// Set whether this View is enabled. A disabled View does not receive

/// keyboard or mouse inputs. If |enabled| differs from the current value the

/// View will be repainted. Also, clears focus if the focused View is

/// disabled.

///

/*--cef()--*/

virtual void SetEnabled(bool enabled) = 0;

///

/// Returns whether this View is enabled.

///

/*--cef()--*/

virtual bool IsEnabled() = 0;

///

/// Sets whether this View is capable of taking focus. It will clear focus if

/// the focused View is set to be non-focusable. This is false by default so

/// that a View used as a container does not get the focus.

///

/*--cef()--*/

virtual void SetFocusable(bool focusable) = 0;

///

/// Returns true if this View is focusable, enabled and drawn.

///

/*--cef()--*/

virtual bool IsFocusable() = 0;

///

/// Return whether this View is focusable when the user requires full keyboard

/// access, even though it may not be normally focusable.

///

/*--cef()--*/

virtual bool IsAccessibilityFocusable() = 0;

///

/// Request keyboard focus. If this View is focusable it will become the

/// focused View.

///

/*--cef()--*/

virtual void RequestFocus() = 0;

///

/// Sets the background color for this View. The background color will be

/// automatically reset when CefViewDelegate::OnThemeChanged is called.

///

/*--cef()--*/

virtual void SetBackgroundColor(cef_color_t color) = 0;

///

/// Returns the background color for this View. If the background color is

/// unset then the current `GetThemeColor(CEF_ColorPrimaryBackground)` value

/// will be returned. If this View belongs to an overlay (created with

/// CefWindow::AddOverlayView), and the background color is unset, then a

/// value of transparent (0) will be returned.

///

/*--cef()--*/

virtual cef_color_t GetBackgroundColor() = 0;

///

/// Returns the current theme color associated with |color_id|, or the

/// placeholder color (red) if unset. See cef_color_ids.h for standard ID

/// values. Standard colors can be overridden and custom colors can be added

/// using CefWindow::SetThemeColor.

///

/*--cef()--*/

virtual cef_color_t GetThemeColor(int color_id) = 0;

///

/// Convert |point| from this View's coordinate system to DIP screen

/// coordinates. This View must belong to a Window when calling this method.

/// Returns true if the conversion is successful or false otherwise. Use

/// CefDisplay::ConvertPointToPixels() after calling this method if further

/// conversion to display-specific pixel coordinates is desired.

///

/*--cef()--*/

virtual bool ConvertPointToScreen(CefPoint& point) = 0;

///

/// Convert |point| to this View's coordinate system from DIP screen

/// coordinates. This View must belong to a Window when calling this method.

/// Returns true if the conversion is successful or false otherwise. Use

/// CefDisplay::ConvertPointFromPixels() before calling this method if

/// conversion from display-specific pixel coordinates is necessary.

///

/*--cef()--*/

virtual bool ConvertPointFromScreen(CefPoint& point) = 0;

///

/// Convert |point| from this View's coordinate system to that of the Window.

/// This View must belong to a Window when calling this method. Returns true

/// if the conversion is successful or false otherwise.

///

/*--cef()--*/

virtual bool ConvertPointToWindow(CefPoint& point) = 0;

///

/// Convert |point| to this View's coordinate system from that of the Window.

/// This View must belong to a Window when calling this method. Returns true

/// if the conversion is successful or false otherwise.

///

/*--cef()--*/

virtual bool ConvertPointFromWindow(CefPoint& point) = 0;

///

/// Convert |point| from this View's coordinate system to that of |view|.

/// |view| needs to be in the same Window but not necessarily the same view

/// hierarchy. Returns true if the conversion is successful or false

/// otherwise.

///

/*--cef()--*/

virtual bool ConvertPointToView(CefRefPtr<CefView> view, CefPoint& point) = 0;

///

/// Convert |point| to this View's coordinate system from that |view|. |view|

/// needs to be in the same Window but not necessarily the same view

/// hierarchy. Returns true if the conversion is successful or false

/// otherwise.

///

/*--cef()--*/

virtual bool ConvertPointFromView(CefRefPtr<CefView> view,

CefPoint& point) = 0;