views: Add groups and focus/blur callbacks (issue #2102)

- cefclient: Only make menus focusable when ALT is pressed.
- cefclient: Display sample top menu when passed the `--show-top-menu`
  command-line flag.

include/capi/views/cef_view_capi.h

@@ -148,6 +148,18 @@ typedef struct _cef_view_t {
   ///
   void (CEF_CALLBACK *set_id)(struct _cef_view_t* self, int id);
 
+  ///
+  // Returns the group id of this View, or -1 if not set.
+  ///
+  int (CEF_CALLBACK *get_group_id)(struct _cef_view_t* self);
+
+  ///
+  // 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.
+  ///
+  void (CEF_CALLBACK *set_group_id)(struct _cef_view_t* self, int group_id);
+
   ///
   // Returns the View that contains this View, if any.
   ///

include/capi/views/cef_view_delegate_capi.h

@@ -105,6 +105,18 @@ typedef struct _cef_view_delegate_t {
   ///
   void (CEF_CALLBACK *on_child_view_changed)(struct _cef_view_delegate_t* self,
       struct _cef_view_t* view, int added, struct _cef_view_t* child);
+
+  ///
+  // Called when |view| gains focus.
+  ///
+  void (CEF_CALLBACK *on_focus)(struct _cef_view_delegate_t* self,
+      struct _cef_view_t* view);
+
+  ///
+  // Called when |view| loses focus.
+  ///
+  void (CEF_CALLBACK *on_blur)(struct _cef_view_delegate_t* self,
+      struct _cef_view_t* view);
 } cef_view_delegate_t;
 
 

include/views/cef_view.h

@@ -145,6 +145,20 @@ class CefView : public CefBaseRefCounted {
   /*--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.
   ///

include/views/cef_view_delegate.h

@@ -108,6 +108,18 @@ class CefViewDelegate : public virtual CefBaseRefCounted {
   virtual void OnChildViewChanged(CefRefPtr<CefView> view,
                                   bool added,
                                   CefRefPtr<CefView> child) {}
+
+  ///
+  // Called when |view| gains focus.
+  ///
+  /*--cef()--*/
+  virtual void OnFocus(CefRefPtr<CefView> view) {}
+
+  ///
+  // Called when |view| loses focus.
+  ///
+  /*--cef()--*/
+  virtual void OnBlur(CefRefPtr<CefView> view) {}
 };
 
 #endif  // CEF_INCLUDE_VIEWS_CEF_WINDOW_DELEGATE_H_