Xport Interface: stylesheet::push_back

Inserts a stylesheet rule, comment, or import rule into the called stylesheet.

void stylesheet::push_back(
  const stylesheet_item& item
);

Parameters

item

A stylesheet_item object to be inserted. As stylesheet_item is a base class, the passed object will actually be one of the following types, stylesheet_rule, stylesheet_import, or stylesheet_comment.

Returns

Nothing.

Remarks

This operation is used to insert stylesheet items into the called stylesheet. The most common stylesheet item you'll insert into a stylesheet is a stylesheet_rule. This operation is similar to stylesheet::insert(item), except this operation does not return an iterator to the inserted stylesheet item.

Complexity

Logarithmic

Examples

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

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

  stylesheet ss;

  // add a couple rules to the stylesheet
  stylesheet_rule h1_rule("h1");
  h1_rule.insert(declaration(text_align, "center"));
  h1_rule.insert(declaration(css::color, "red"));
  ss.push_back(h1_rule);

  stylesheet_rule p_rule("p");
  p_rule.insert(declaration(padding_left, "10px"));
  p_rule.insert(declaration(margin_top, "5px"));
  ss.push_back(p_rule);

  // write the stylehsheet to cout
  stylesheet_formatter fmtr(std::cout);
  fmtr << ss;
}