SOUI项目的SVN根目录下有一个doc目录，下面有一份控件属性表。包含了大部分控件的大部分属性，不过也不一定完全准确。最保险的办法还是查源代码。
SOUI对象包含控件及ISkinObj等从SObject派生的对象都可以使用XML配置属性。要知道如何查SOUI对象属性，首先要看一下SOUI解释属性的流程。
BOOL SObject::InitFromXml( pugi::xml_node xmlNode )
{
if(!xmlNode) return FALSE;
#ifdef _DEBUG
{
pugi::xml_writer_buff writer;
xmlNode.print(writer,L"\t",pugi::format_default,pugi::encoding_utf16);
m_strXml=SStringW(writer.buffer(),writer.size());
}
#endif //设置当前对象的属性 //优先处理"class"属性
pugi::xml_attribute attrClass=xmlNode.attribute(L"class");
if(attrClass)
{
attrClass.set_userdata(); //预处理过的属性，给属性增加一个userdata
SetAttribute(attrClass.name(), attrClass.value(), TRUE);
}
for (pugi::xml_attribute attr = xmlNode.first_attribute(); attr; attr = attr.next_attribute())
{
if(attr.get_userdata()) continue; //忽略已经被预处理的属性
SetAttribute(attr.name(), attr.value(), TRUE);
}
if(attrClass)
{
attrClass.set_userdata();
}
//调用初始化完成接口
OnInitFinished(xmlNode);
return TRUE;
}
在InitFromXml方法中，首先获取class属性交给对象解释，然后再枚举其它属性。
获取到一个属性以后调用SOjbect::SetAttribute方法来处理属性。
class SObject{
public
virtual HRESULT SetAttribute(const SStringW & strAttribName, const SStringW & strValue, BOOL bLoading)
{
return DefAttributeProc(strAttribName,strValue,bLoading);
}
};
SetAttribute是一个虚函数，所有派生类都可以通过重载该方法来实现不同属性的处理。
在SOUI中提供了一组宏来处理SObject的属性，下面看一下SWindow类的实现：
SOUI_ATTRS_BEGIN()
ATTR_CUSTOM(L"id",OnAttrID)
ATTR_STRINGW(L"name",m_strName,FALSE)
ATTR_CUSTOM(L"skin", OnAttrSkin) //直接获得皮肤对象
ATTR_SKIN(L"ncskin", m_pNcSkin, TRUE) //直接获得皮肤对象
ATTR_CUSTOM(L"class", OnAttrClass) //获得style
ATTR_INT(L"data", m_uData, )
ATTR_CUSTOM(L"enable", OnAttrEnable)
ATTR_CUSTOM(L"visible", OnAttrVisible)
ATTR_CUSTOM(L"show", OnAttrVisible)
ATTR_CUSTOM(L"display", OnAttrDisplay)
ATTR_CUSTOM(L"pos", OnAttrPos)
ATTR_CUSTOM(L"offset", OnAttrOffset)
ATTR_CUSTOM(L"pos2type", OnAttrPos2type)
ATTR_CUSTOM(L"cache", OnAttrCache)
ATTR_CUSTOM(L"alpha",OnAttrAlpha)
ATTR_CUSTOM(L"layeredWindow",OnAttrLayeredWindow)
ATTR_CUSTOM(L"trackMouseEvent",OnAttrTrackMouseEvent)
ATTR_I18NSTRT(L"tip", m_strToolTipText, FALSE) //使用语言包翻译
ATTR_INT(L"msgTransparent", m_bMsgTransparent, FALSE)
ATTR_INT(L"maxWidth",m_nMaxWidth,FALSE)
ATTR_INT(L"clipClient",m_bClipClient,FALSE)
ATTR_INT(L"focusable",m_bFocusable,FALSE)
ATTR_INT(L"float",m_bFloat,FALSE)
ATTR_CHAIN(m_style) //支持对style中的属性定制
SOUI_ATTRS_END()
SOUI_ATTRS_BEGIN + SOUI_ATTRS_END宏展开构成一个空的SetAttribute函数。
ATTR_XXX则对不同类型的属性提供一种固定的处理方式，全部属性形成一个属性映射表。 因此要查对象属性，首先就是查对象代码中对应的属性映射表，同时也别忘记去查对象的基类的属性映射表。 有些对象（如Richedit)的属性可能在这个属性映射表里找不到，那又是为什么呢？
注意SetAttribute最后调用了DefAttributeProc，使用属性映射表构造的属性处理函数也同样会调用DefAttributeProc。
在DefAttributeProc中可以批量的按照自己的方式处理属性。下面看一下Richedit::DefAttributeProc的实现：
HRESULT SRichEdit::DefAttributeProc(const SStringW & strAttribName,const SStringW & strValue, BOOL bLoading)
{
HRESULT hRet=S_FALSE;
DWORD dwBit=,dwMask=;
//hscrollbar
if(strAttribName.CompareNoCase(L"hscrollBar")==)
{
if(strValue==L"")
m_dwStyle&=~WS_HSCROLL;
else
m_dwStyle|=WS_HSCROLL;
dwBit|=TXTBIT_SCROLLBARCHANGE;
dwMask|=TXTBIT_SCROLLBARCHANGE;
}
//vscrollbar
else if(strAttribName.CompareNoCase(L"vscrollBar")==)
{
if(strValue==L"")
m_dwStyle&=~WS_VSCROLL;
else
m_dwStyle|=WS_VSCROLL;
dwBit|=TXTBIT_SCROLLBARCHANGE;
dwMask|=TXTBIT_SCROLLBARCHANGE;
}
//auto hscroll
else if(strAttribName.CompareNoCase(L"autoHscroll")==)
{
if(strValue==L"")
m_dwStyle&=~ES_AUTOHSCROLL;
else
m_dwStyle|=ES_AUTOHSCROLL;
dwBit|=TXTBIT_SCROLLBARCHANGE;
dwMask|=TXTBIT_SCROLLBARCHANGE;
}
//auto hscroll
else if(strAttribName.CompareNoCase(L"autoVscroll")==)
{
if(strValue==L"")
m_dwStyle&=~ES_AUTOVSCROLL;
else
m_dwStyle|=ES_AUTOVSCROLL;
dwBit|=TXTBIT_SCROLLBARCHANGE;
dwMask|=TXTBIT_SCROLLBARCHANGE;
}
//multilines
else if(strAttribName.CompareNoCase(L"multiLines")==)
{
if(strValue==L"")
m_dwStyle&=~ES_MULTILINE;
else
m_dwStyle|=ES_MULTILINE,dwBit|=TXTBIT_MULTILINE;
dwMask|=TXTBIT_MULTILINE;
}
//readonly
else if(strAttribName.CompareNoCase(L"readOnly")==)
{
if(strValue==L"")
m_dwStyle&=~ES_READONLY;
else
m_dwStyle|=ES_READONLY,dwBit|=TXTBIT_READONLY;
dwMask|=TXTBIT_READONLY;
if(!bLoading)
{//update dragdrop
OnEnableDragDrop(!(m_dwStyle&ES_READONLY) && m_fEnableDragDrop);
}
}
//want return
else if(strAttribName.CompareNoCase(L"wantReturn")==)
{
if(strValue==L"")
m_dwStyle&=~ES_WANTRETURN;
else
m_dwStyle|=ES_WANTRETURN;
}
//password
else if(strAttribName.CompareNoCase(L"password")==)
{
if(strValue==L"")
m_dwStyle&=~ES_PASSWORD;
else
m_dwStyle|=ES_PASSWORD,dwBit|=TXTBIT_USEPASSWORD;
dwMask|=TXTBIT_USEPASSWORD;
}
//number
else if(strAttribName.CompareNoCase(L"number")==)
{
if(strValue==L"")
m_dwStyle&=~ES_NUMBER;
else
m_dwStyle|=ES_NUMBER;
}
//password char
else if(strAttribName.CompareNoCase(L"passwordChar")==)
{
SStringT strValueT=S_CW2T(strValue);
m_chPasswordChar=strValueT[];
}
//enabledragdrop
else if(strAttribName.CompareNoCase(L"enableDragdrop")==)
{
if(strValue==L"")
{
m_fEnableDragDrop=FALSE;
}else
{
m_fEnableDragDrop=TRUE;
}
if(!bLoading)
{
OnEnableDragDrop( !(m_dwStyle&ES_READONLY) & m_fEnableDragDrop);
}
}
//auto Sel
else if(strAttribName.CompareNoCase(L"autoSel")==)
{
if(strValue==L"")
{
m_fAutoSel=FALSE;
}else
{
m_fAutoSel=TRUE;
}
}
else
{
hRet=__super::DefAttributeProc(strAttribName,strValue,bLoading);
}
if(!bLoading)
{
m_pTxtHost->GetTextService()->OnTxPropertyBitsChange(dwMask,dwBit);
hRet=TRUE;
}
return hRet;
}
可以看到在这个方法中对很多属性做了处理。
总结：
先查目标对象的属性映射表，再找基类的属性映射表，最后查对象的DefAttributeProc。