Xport Interface: stylesheet_rule::write

Writes the called stylesheet_rule to a file or output stream, through a stylesheet_formatter object.

virtual bool stylesheet_rule::write(
  const stylesheet_formatter& fmtr
);

Parameters

fmtr

A formatter object, which allows the user to set specific formatting options before writing the stylesheet rule.

Returns

true if the stylesheet_rule is written successfully, false otherwise.

Remarks

This operation is used to write a stylesheet_rule. Normally, however, you will not use this operation to write a single stylesheet rule. You'll normally use stylesheet::write() which writes the whole stylesheet, rather than a single rule. This operations was added for completeness, however, in case users would like to write portions of the stylesheet rather than the whole stylesheet.

In this operation, you pass a stylesheet_formatter which writes the stylesheet_rule to the file or output stream that was specified when creating the stylesheet_formatter object. A stylesheet_formatter is first created, and in it's constructor, the filename or output stream is specified. Then, there are many formatting options which can be set on the formatter object, which will determine how the stylesheet_rule item will look when written.

Complexity

Linear

Example

Examples

#include "xhtml_doc.h"
#include "xport_brochure.h"
#include <iostream>

int main(int argc, char* argv[])
{
  using namespace Xport;

  document doc(root_doc);
  stylesheet ss;

  xport_brochure broch;
  broch.create(doc, ss);

  // iterate over the stylesheet, and output each rule
  std::cout << "Listing all the rules in xport brochure's stylesheet.\n\n";
  stylesheet_formatter fmtr(std::cout);

  stylesheet::const_iterator it = ss.begin();
  for (; it != ss.end(); ++it) {
    if (it->stylesheet_item_type() == sit_rule) {
      it->write(fmtr);
      std::cout << "\n";
    }
  }
  std::cout << "\n\n";
}