Home	Xport Overview	Xport Download	XportPro Overview	Buy XportPro Now!

Xport Interface: `element::style`

Sets or retrieves a style attribute value for the called element.

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

virtual bool element::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

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;
}

Datasoft Solutions is proud to present their landmark product, Work Time Studio. Utilizing the tree container library, Work Time Studio provides unparalleled features in personal time, project and task management software. If you're looking for a way to increase your productivity, visit Work Time Studio's product website, and start being more productive today.

XHTML Parsing &Objective Reporting Toolkit

Xport Interface: element::style