Xport Interface: markup::style

For a derived element object, adds or retrieves a style attribute value.

virtual std::string markup::style(1st Variety
  css_property prop
);

virtual bool markup::style(2nd Variety
  css_property prop
  const std::string& value
);

Parameters

prop

A css_property enumerator. For a list of css_property enumerators, see Xport Usage: Enumerations.

value

A string value which represents the value of the accompanied css property.

Returns

In the first variety, returns the string value of the specified property if called on an element object and the style attribute is present within the element, or an empty string otherwise. In the second variety, returns true if called on an element object and the style is set successfully, false otherwise.

Remarks

This operation is revelant only if it is called on an element derived object. If called on a pcdata, comment, or procinstr object, the first variety will always return an empty string, and the second variety will always return false.

The first variety is used to retrieve a css property value which is set in the element's style attribute. If the specified property is not present, returns an empty string. The second variety is used to set the css property of an element to the specified value within the element's style attribute.

Complexity

Constant

Example

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

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

  // create an xhtml strict root document 
  document doc(root_doc);

  // insert an unordered list into the body
  markup::iterator it = doc.body()->insert(element(ul));

  markup::iterator li_it = it->insert(element(li) << "item 1");
  li_it->style(css::color, "red");

  li_it = it->insert(element(li) << "Item 2");
  li_it->style(font_weight, "bold");

  li_it = it->insert(element(li) << "Item 3");
  li_it->style(list_style_type, "square");

  // output the document to cout
  formatter fmtr(std::cout);
  doc.write(fmtr);

  // now iterate over the list items and retrieve the style property values
  li_it = it->begin();
  for (int list_item = 1; li_it != it->end(); ++li_it, ++list_item) {
    std::cout << "List Item " << list_item << ": color = '" << li_it->style(css::color) << 
    "'\n";
    std::cout << "List Item " << list_item << ": font-weight = '" << li_it->style(font_weight) << 
    "'\n";
    std::cout << "List Item " << list_item << ": list-style-type= '" << li_it->style( 
    list_style_type) << "'\n\n";
  }

  return 0;
}