CMarkup SetChildAttrib Method

bool CMarkup::SetChildAttrib( MCD_CSTR szAttrib, MCD_CSTR szValue, int nFlags = 0 );
bool CMarkup::SetChildAttrib( MCD_CSTR szAttrib, int nValue, int nFlags = 0 );

Calling SetChildAttrib adds or changes the attribute named szAttrib in the child position element to have the specified value (see SetAttrib to modify main position attributes). If the attribute already exists for the child position element, the value is changed. Otherwise the attribute and its value are added. The method returns false if there is no child position element.

Update September 27, 2008: In CMarkup release 10.0 you can specify MNF_WITHREFS in the optional nFlags argument to set an attribute value with numeric character references or entities. This tells CMarkup not to double escape ampersands that are followed by an entity name or numeric character reference and semi-colon. Here is an example setting the attribute with an escaped ampersand in the href attribute of an HTML hyperlink.

html.SetChildAttrib( "href",
  "http://example.com/?a=1&b=2", CMarkup::MNF_WITHREFS );

The AddChildAttrib method is no longer used and was the same as SetChildAttrib. The term "Add" is misleading because an element can only have one attribute of a given name.