PDF Printing: embed browser user agent string in PDF metadata.

printing/print_settings.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 PRINTING_PRINT_SETTINGS_H_
 #define PRINTING_PRINT_SETTINGS_H_
 
 #include <string>
 
 #include "base/strings/string16.h"
 #include "printing/page_range.h"
 #include "printing/page_setup.h"
 #include "printing/print_job_constants.h"
 #include "printing/printing_export.h"
 #include "ui/gfx/geometry/rect.h"
 
 namespace printing {
 
 // Returns true if |color_mode| is color and not B&W.
 PRINTING_EXPORT bool IsColorModelSelected(int color_mode);
 
 #if defined(USE_CUPS)
 // Get the color model setting name and value for the |color_mode|.
 PRINTING_EXPORT void GetColorModelForMode(int color_mode,
                                           std::string* color_setting_name,
                                           std::string* color_value);
 #endif
 
+// Inform the printing system that it may embed this user-agent string
+// in its output's metadata.
+PRINTING_EXPORT void SetAgent(const std::string&);

[Lei Zhang, 2015/11/05 21:37:23]

include the parameter name

[hal.canary, 2015/11/05 22:16:48]

done

+PRINTING_EXPORT const std::string& GetAgent();
+
 // OS-independent print settings.
 class PRINTING_EXPORT PrintSettings {
  public:
   // Media properties requested by the user. Default instance represents
   // default media selection.
   struct RequestedMedia {
     // Size of the media, in microns.
     gfx::Size size_microns;
     // Platform specific id to map it back to the particular media.
     std::string vendor_id;
@@ skipping 176 matching lines @@
   // True if this printer supports AlphaBlend.
   bool supports_alpha_blend_;
 
   // If margin type is custom, this is what was requested.
   PageMargins requested_custom_margins_in_points_;
 };
 
 }  // namespace printing
 
 #endif  // PRINTING_PRINT_SETTINGS_H_