Add worksheet option to print in black and white.

include/xlsxwriter/worksheet.h

@@ -2188,6 +2188,7 @@ typedef struct lxw_worksheet {
     uint8_t show_zeros;
     uint8_t vcenter;
     uint8_t zoom_scale_normal;
+    uint8_t black_white;
     uint8_t num_validations;
     uint8_t has_dynamic_arrays;
     char *vba_codename;
@@ -5372,6 +5373,18 @@ void worksheet_set_start_page(lxw_worksheet *worksheet, uint16_t start_page);
  */
 void worksheet_set_print_scale(lxw_worksheet *worksheet, uint16_t scale);
 
+/**
+ * @brief Set the worksheet to print in black and white
+ *
+ * @param worksheet Pointer to a lxw_worksheet instance to be updated.
+ *
+ * Set the option to print the worksheet in black and white:
+ * @code
+ *     worksheet_print_black_and_white(worksheet);
+ * @endcode
+ */
+void worksheet_print_black_and_white(lxw_worksheet *worksheet);
+
 /**
  * @brief Display the worksheet cells from right to left for some versions of
  *        Excel.

src/worksheet.c

@@ -2626,6 +2626,9 @@ _worksheet_write_page_setup(lxw_worksheet *self)
     else
         LXW_PUSH_ATTRIBUTES_STR("orientation", "landscape");
 
+    if (self->black_white)
+        LXW_PUSH_ATTRIBUTES_STR("blackAndWhite", "1");
+
     /* Set start page active flag. */
     if (self->page_start)
         LXW_PUSH_ATTRIBUTES_INT("useFirstPageNumber", 1);
@@ -10060,6 +10063,16 @@ worksheet_set_print_scale(lxw_worksheet *self, uint16_t scale)
     self->page_setup_changed = LXW_TRUE;
 }
 
+/*
+ * Set the print in black and white option.
+ */
+void
+worksheet_print_black_and_white(lxw_worksheet *self)
+{
+    self->black_white = LXW_TRUE;
+    self->page_setup_changed = LXW_TRUE;
+}
+
 /*
  * Store the horizontal page breaks on a worksheet.
  */

test/functional/src/test_print_options07.c

@@ -0,0 +1,25 @@
+/*****************************************************************************
+ * Test cases for libxlsxwriter.
+ *
+ * Test to compare output against Excel files.
+ *
+ * Copyright 2014-2022, John McNamara, [email protected]
+ *
+ */
+
+#include "xlsxwriter.h"
+
+int main() {
+
+    lxw_workbook  *workbook  = workbook_new("test_print_options07.xlsx");
+    lxw_worksheet *worksheet = workbook_add_worksheet(workbook, NULL);
+
+    worksheet_write_string(worksheet, 0, 0, "Foo" , NULL);
+
+    worksheet_set_paper(worksheet, 9);
+    worksheet->vertical_dpi = 200;
+
+    worksheet_print_black_and_white(worksheet);
+
+    return workbook_close(workbook);
+}

test/functional/test_print_options.py

@@ -37,4 +37,6 @@ def test_print_options06(self):
         self.ignore_elements = {'xl/worksheets/sheet1.xml': ['<pageMargins']}
         self.run_exe_test('test_print_options06')
 
-
+    def test_print_options07(self):
+        self.ignore_elements = {'xl/worksheets/sheet1.xml': ['<pageMargins']}
+        self.run_exe_test('test_print_options07')