BUI::XMLItemW类 参考

Public 成员函数
	XMLItemW ()
	~XMLItemW ()
BeStringPairW &	LabelPair ()
	节点名称和节点文本内容
void	ReleaseChild ()
	释放所有孩子节点
size_t	GetChildCounts () const
	子节点总数
XMLItemW *	GetChildObject (int index) const
	获得索引(index)位置的子节点
unsigned int	AttrbuteCount () const
	属性的总数
BeStringPairW &	AttrbuteTextPair (unsigned int i)
	获得索引(i)位置的属性键值对
void	AppendAttrbute (BeStringW key, BeStringW value)
	添加属性键值对
XMLItemW *	FirstChild () const
	第一个孩子节点
XMLItemW *	LastChild () const
	最后一个孩子节点
XMLItemW *	PrevSibling () const
	上一个兄弟节点
XMLItemW *	NextSibling () const
	下一个兄弟节点
XMLItemW *	Parent () const
	父节点
void	RemoveAllAttrbute ()
	删除所有属性
void	RemoveAttrbute (const WCHAR *name)
	删除指定属性
BOOL	SetAttribute (const WCHAR *name, const BeStringW &str_value)
	设置属性值
void	BreakAway (BOOL isReleaseAllChild)
	脱离dom结构
BOOL	FindAttribute (const WCHAR *name, BeStringW &outstr)
	查找属性
const WCHAR *	FindAttributeChar (const WCHAR *name)
	查找属性
long	FindAttributeInt (const WCHAR *name, long default_value)
	查找属性整数值
double	FindAttributeFloat (const WCHAR *name, double default_value)
	查找属性浮点数
XMLItemW *	FindChildByName (const WCHAR *name, BOOL createWhenNoFind=FALSE)
	在后续兄弟节点中，查找指定名称的节点
XMLItemW *	NextSiblingElement (const WCHAR *name)
	查询节点
XMLItemW *	FindObjectByKeyPath (const WCHAR *keyPath, BOOL createWhenNoFind=FALSE)
	一次读取层级节点信息。通过不断匹配keyPath的方式向深层次节点查找，直到匹配。例如123
XMLItemW *	FindObjectByAttributePath (const WCHAR *attrName, const WCHAR *attrPath) const
	根据执行属性名的值，为一次读取层级节点信息。通过不断匹配keyPath的方式向深层次节点查找，直到匹配
void	StandardizationItem (void(*callback_free)(XMLItemW *node)=NULL)
	标准化树(将单一子节点，设置为节点的属性值)
XMLItemW *	AppendChild (const WCHAR *key=NULL, const WCHAR *value=NULL, int type=-1, BOOL addtail=TRUE)
	添加子节点。
void	Print (FILE *fp, BOOL bFormate, int depth)
	将此节点输出到文件中
void	Clone (XMLItemW *otherNode)
	将otherNode克隆到this节点。用于存储

静态 Public 成员函数
static XMLItemW *	NextItem (XMLItemW *item)
	不用递归的遍历时调用

Public 属性
XMLItemW *	parent
XMLItemW *	first_child
XMLItemW *	last_child
XMLItemW *	prev_sibling
XMLItemW *	next_sibling
BeStringPairW	label
std::vector< BeStringPairW >	attribute_list
int	type_

Protected 成员函数
XMLItemW *	AllocXmlNode (int type)

构造及析构函数说明

XMLItemW()

BUI::XMLItemW::XMLItemW

(

)

~XMLItemW()

BUI::XMLItemW::~XMLItemW

(

)

成员函数说明

AllocXmlNode()

XMLItemW * BUI::XMLItemW::AllocXmlNode ( int  type )

protected

AppendAttrbute()

void BUI::XMLItemW::AppendAttrbute	(	BeStringW	key,
		BeStringW	value
	)

添加属性键值对

AppendChild()

XMLItemW * BUI::XMLItemW::AppendChild	(	const WCHAR *	key = NULL,
		const WCHAR *	value = NULL,
		int	type = -1,
		BOOL	addtail = TRUE
	)

添加子节点。

参数

key	: 节点名称
value	: 节点值
type	: 节点类型
addtail	: 是否加入到末尾

返回

XMLItemA* : 返回新的节点

AttrbuteCount()

unsigned int BUI::XMLItemW::AttrbuteCount

(

)

const

属性的总数

AttrbuteTextPair()

BeStringPairW & BUI::XMLItemW::AttrbuteTextPair

(

unsigned int

i

)

获得索引(i)位置的属性键值对

BreakAway()

void BUI::XMLItemW::BreakAway

(

BOOL

isReleaseAllChild

)

脱离dom结构

参数

isReleaseAllChild

当为TRUE时，并且释放所有孩子节点占用内存，初始化为NULL。为FALSE时 仅脱离dom结构，并保留孩子节点

Clone()

void BUI::XMLItemW::Clone

(

XMLItemW *

otherNode

)

将otherNode克隆到this节点。用于存储

参数

otherNode

被克隆对象

FindAttribute()

BOOL BUI::XMLItemW::FindAttribute	(	const WCHAR *	name,
		BeStringW &	outstr
	)

查找属性

参数

name	: 属性名称
outstr	:若存在，则输出属性值

返回

BOOL : 成功标志

FindAttributeChar()

const WCHAR * BUI::XMLItemW::FindAttributeChar

(

const WCHAR *

name

)

查找属性

参数

name

: 属性名称

返回

const WCHAR* : 若存在，则输出属性值字符串指针；若不存在，返回NULL

FindAttributeFloat()

double BUI::XMLItemW::FindAttributeFloat	(	const WCHAR *	name,
		double	default_value
	)

查找属性浮点数

参数

name	: 属性名称
default_value	: 默认值

返回

double : 属性结果

FindAttributeInt()

long BUI::XMLItemW::FindAttributeInt	(	const WCHAR *	name,
		long	default_value
	)

查找属性整数值

参数

name	: 属性名称
default_value	: 默认值

返回

long : 属性结果

FindChildByName()

XMLItemW * BUI::XMLItemW::FindChildByName	(	const WCHAR *	name,
		BOOL	createWhenNoFind = FALSE
	)

在后续兄弟节点中，查找指定名称的节点

参数

name

: 节点名称

返回

XMLItemA* : 节点对象

FindObjectByAttributePath()

XMLItemW * BUI::XMLItemW::FindObjectByAttributePath	(	const WCHAR *	attrName,
		const WCHAR *	attrPath
	)		const

根据执行属性名的值，为一次读取层级节点信息。通过不断匹配keyPath的方式向深层次节点查找，直到匹配

参数

attrName
attrPath	"a.b.c"(此时树状结构123)

返回

XMLItemA* 返回匹配的节点

FindObjectByKeyPath()

XMLItemW * BUI::XMLItemW::FindObjectByKeyPath	(	const WCHAR *	keyPath,
		BOOL	createWhenNoFind = FALSE
	)

一次读取层级节点信息。通过不断匹配keyPath的方式向深层次节点查找，直到匹配。例如123

参数

keyPath

"a.b.c"(此时树状结构123)

返回

XMLItemA* 返回匹配的节点

FirstChild()

XMLItemW * BUI::XMLItemW::FirstChild

(

)

const

第一个孩子节点

GetChildCounts()

size_t BUI::XMLItemW::GetChildCounts

(

)

const

子节点总数

GetChildObject()

XMLItemW * BUI::XMLItemW::GetChildObject

(

int

index

)

const

获得索引(index)位置的子节点

LabelPair()

BeStringPairW & BUI::XMLItemW::LabelPair

(

)

节点名称和节点文本内容

LastChild()

XMLItemW * BUI::XMLItemW::LastChild

(

)

const

最后一个孩子节点

NextItem()

static XMLItemW * BUI::XMLItemW::NextItem ( XMLItemW *  item )

static

不用递归的遍历时调用

NextSibling()

XMLItemW * BUI::XMLItemW::NextSibling

(

)

const

下一个兄弟节点

NextSiblingElement()

XMLItemW * BUI::XMLItemW::NextSiblingElement

(

const WCHAR *

name

)

查询节点

参数

name	节点名称
createWhenNoFind	当为查询到时创建节点

返回

XMLItemA* 返回节点

Parent()

XMLItemW * BUI::XMLItemW::Parent

(

)

const

父节点

PrevSibling()

XMLItemW * BUI::XMLItemW::PrevSibling

(

)

const

上一个兄弟节点

Print()

void BUI::XMLItemW::Print	(	FILE *	fp,
		BOOL	bFormate,
		int	depth
	)

将此节点输出到文件中

参数

fp	:文件句柄
bFormate	: 是否格式化
depth	: 节点深度，用于计算前缀缩进

ReleaseChild()

void BUI::XMLItemW::ReleaseChild

(

)

释放所有孩子节点

RemoveAllAttrbute()

void BUI::XMLItemW::RemoveAllAttrbute

(

)

删除所有属性

RemoveAttrbute()

void BUI::XMLItemW::RemoveAttrbute

(

const WCHAR *

name

)

删除指定属性

SetAttribute()

BOOL BUI::XMLItemW::SetAttribute	(	const WCHAR *	name,
		const BeStringW &	str_value
	)

设置属性值

StandardizationItem()

void BUI::XMLItemW::StandardizationItem

(

void(*)(XMLItemW *node)

callback_free = NULL

)

标准化树(将单一子节点，设置为节点的属性值)

参数

callback_free

释放节点回调函数

类成员变量说明

attribute_list

std::vector<BeStringPairW> BUI::XMLItemW::attribute_list

first_child

XMLItemW* BUI::XMLItemW::first_child

label

BeStringPairW BUI::XMLItemW::label

last_child

XMLItemW* BUI::XMLItemW::last_child

next_sibling

XMLItemW* BUI::XMLItemW::next_sibling

parent

XMLItemW* BUI::XMLItemW::parent

prev_sibling

XMLItemW* BUI::XMLItemW::prev_sibling

type_

int BUI::XMLItemW::type_