Expand SecurityStyleChanged interfaces to include explanations

content/public/browser/web_contents_delegate.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_DELEGATE_H_
 #define CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_DELEGATE_H_
 
 #include <set>
 #include <string>
 
@@ skipping 468 matching lines @@
   virtual void MoveValidationMessage(WebContents* web_contents,
                                      const gfx::Rect& anchor_in_root_view) {}
 
   // Returns true if the WebContents is never visible.
   virtual bool IsNeverVisible(WebContents* web_contents);
 
   // Called in response to a request to save a frame. If this returns true, the
   // default behavior is suppressed.
   virtual bool SaveFrame(const GURL& url, const Referrer& referrer);
 
-  // Can be overridden by a delegate to return the security style of the given
-  // |web_contents|. Returns SECURITY_STYLE_UNKNOWN if not overriden.
-  virtual SecurityStyle GetSecurityStyle(WebContents* web_contents);
+  // Can be overridden by a delegate to return the security style of the
+  // given |web_contents|, populating |security_style_explanation| to
+  // explain why the SecurityStyle was downgraded. Returns
+  // SECURITY_STYLE_UNKNOWN if not overriden.
+  virtual SecurityStyle GetSecurityStyle(
+      WebContents* web_contents,
+      SecurityStyleExplanation* security_style_explanation);
 
  protected:
   virtual ~WebContentsDelegate();
 
  private:
   friend class WebContentsImpl;
 
   // Called when |this| becomes the WebContentsDelegate for |source|.
   void Attach(WebContents* source);
 
   // Called when |this| is no longer the WebContentsDelegate for |source|.
   void Detach(WebContents* source);
 
   // The WebContents that this is currently a delegate for.
   std::set<WebContents*> attached_contents_;
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_DELEGATE_H_