Expand SecurityStyleChanged interfaces to include explanations

content/public/browser/web_contents_observer.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_OBSERVER_H_
 #define CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_OBSERVER_H_
 
 #include "base/process/kill.h"
 #include "base/process/process_handle.h"
 #include "content/common/content_export.h"
@@ skipping 14 matching lines @@
 class WebContents;
 class WebContentsImpl;
 struct AXEventNotificationDetails;
 struct FaviconURL;
 struct FrameNavigateParams;
 struct LoadCommittedDetails;
 struct LoadFromMemoryCacheDetails;
 struct Referrer;
 struct ResourceRedirectDetails;
 struct ResourceRequestDetails;
+struct SecurityStyleExplanations;
 
 // An observer API implemented by classes which are interested in various page
 // load events from WebContents.  They also get a chance to filter IPC messages.
 //
 // Since a WebContents can be a delegate to almost arbitrarily many
 // RenderViewHosts, it is important to check in those WebContentsObserver
 // methods which take a RenderViewHost that the event came from the
 // RenderViewHost the observer cares about.
 //
 // Usually, observers should only care about the current RenderViewHost as
@@ skipping 126 matching lines @@
       const FrameNavigateParams& params) {}
 
   // And regardless of what frame navigated, this method is invoked after
   // DidCommitProvisionalLoadForFrame was invoked.
   virtual void DidNavigateAnyFrame(
       RenderFrameHost* render_frame_host,
       const LoadCommittedDetails& details,
       const FrameNavigateParams& params) {}
 
   // This method is invoked when the SecurityStyle of the WebContents changes.
-  virtual void SecurityStyleChanged(content::SecurityStyle security_style) {}
+  // |security_style| is the new SecurityStyle. |security_style_explanations|
+  // contains human-readable strings explaining why the SecurityStyle of the
+  // page has been downgraded.
+  virtual void SecurityStyleChanged(
+      SecurityStyle security_style,
+      const SecurityStyleExplanations& security_style_explanations) {}
 
   // This method is invoked once the window.document object of the main frame
   // was created.
   virtual void DocumentAvailableInMainFrame() {}
 
   // This method is invoked once the onload handler of the main frame has
   // completed.
   virtual void DocumentOnLoadCompletedInMainFrame() {}
 
   // This method is invoked when the document in the given frame finished
@@ skipping 203 matching lines @@
   void ResetWebContents();
 
   WebContentsImpl* web_contents_;
 
   DISALLOW_COPY_AND_ASSIGN(WebContentsObserver);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_OBSERVER_H_