图标委派

对象图标的目的是让用户轻松分辨出 Windchill UI 中的不同 Windchill 业务对象。可以在对类进行建模时将图标与模型化类型关联。当显示此类型的对象时，将使用此图标。对于子项类型，“类型和属性管理”实用程序允许用户在 UI 中关联用于表示此子项类型的图标。如果指定的图标无效或为空白，则使用父项类型的图标。此行为使用 IconDelegates 来完成。

Windchill UI 可以处理 Persistable 形式或 TypeInstance 形式的对象，因此 IconDelegates 应该能够处理这两种形式。如果具有 Persistable 形式的对象，则可以轻松使用参与确定图标的属性。如果对象为 TypeInstance 形式且属性不可用，则 TypeInstance 必须对其进行扩展以获得属性，这可能会降低其性能。如果其位于 TypeInstance 对象中，则图标和图标的工具提示将作为 SCA 属性提供，该属性在 <Windchill>\codebase\LogicalAttributes.xml 中定义

<Class name="wt.fc.Persistable">
-------
<Property>
<LogicalForm>objectIcon</LogicalForm>
<ExternalForm>SCA|objectIcon</ExternalForm>
</Property>
<Property>

<LogicalForm>objectTooltip</LogicalForm>
<ExternalForm>NPA|objectTooltip</ExternalForm>
</Property>

AttributeTypeIdentifier PERSONAL_CABINET_ATI =
getIdentifier("personalCabinet", "wt.folder.Cabinet");
TypeIdentifier CABINET_TID = getIdentifier("wt.folder.Cabinet",
null);
protected void initAttributes(Set<AttributeTypeIdentifier>
attributes) {
super.initAttributes(attributes);
attributes.add(PERSONAL_CABINET_ATI);
}
private static class ObjectParams {
Cabinet cabinet = null;
TypeInstance ti = null;
ObjectParams(Cabinet cabinet){
if(cabinet != null)
this.cabinet = cabinet;
}
ObjectParams(TypeInstance ti){
if(ti != null)
this.ti = ti;
}
void reSetObject(Cabinet cabinet){
if(cabinet != null)
this.cabinet = cabinet;
}
boolean isPersonalCabinet(){
if(cabinet != null){
return (cabinet.isPersonalCabinet());
}else{
return (Boolean)ti.get(PERSONAL_CABINET_ATI);
}
}
}
protected boolean inflateRequired() {
boolean need = false;
TypeInstance ti = getTypeInstanceObject();
if(ti != null){
need = super.inflateRequired();
if(!need){
if(ti.get(PERSONAL_CABINET_ATI) == null){ // should contain
PERSONAL_CABINET_ATI
need = true;
}
}
}
return need;
}
private ObjectParams getObjectParams(){
ObjectParams object_params = null;
WTObject obj = super.getObject(false);
TypeInstance ti = getTypeInstanceObject();
if (obj != null && obj instanceof Cabinet) {//Object is available
object_params = new ObjectParams((Cabinet)obj);
} else if(ti != null) {//TypeInstance is available
if(inflateRequired()){
obj = super.getObject(true);
if (obj != null && obj instanceof Cabinet) {
object_params = new ObjectParams((Cabinet)obj);
}else{
object_params = null;
}
} else {
object_params = new ObjectParams(ti);
}
}
return object_params;
}

public IconSelector getStandardIconSelector()
throws WTException, IllegalAccessException,
InvocationTargetException {
IconSelector icon = null;
ObjectParams object_params = getObjectParams();
if(object_params != null){
boolean is_personal_cabinet =
object_params.isPersonalCabinet();
if(is_personal_cabinet)
icon = new IconSelector(PERSONAL_ICON);
else
icon = new IconSelector(SHARED_ICON);
}
if (icon == null)
icon = super.getStandardIconSelector();
return icon;
}

Windchill 类型	IconDelegate
wt.part.WTPart	com.ptc.windchill.enterprise.part.commands.delegate.WTPartIconDelegate
wt.epm.EPMDocument	wt.epm.identity.EPMDocumentIconDelegate
wt.doc.WTDocument	wt.doc.DocumentIconDelegate

元素	类型	说明
<custom_IconDelegate>.java	java	您的 IcondDelegate 运行时位置： <Windchill>\codebase\*
您的 xconf 文件	xconf	注册您的 IconDelegate 运行时位置： <Windchill>\codebase\*

API 签名	说明
public IconSelector getStandardIconSelector() throws WTException, IllegalAccessException, InvocationTargetException;	获取图标的标准选择器
public IconSelector getOpenIconSelector() throws WTException, IllegalAccessException, InvocationTargetException;	在打开对象时获取选择器 (例如，打开文件夹时)

API 签名	说明
public String getToolTip()	要与图标一起显示的工具提示。

API 签名	说明
protected Boolean inflateRequired()	如果 TypeInstance 没有计算图标/工具提示必需的属性，则需要进行扩展。

API 签名	说明
protected void initAttributes(Set<AttributeTypeIdentifier> attributes)	使用驱动确定图标/工具提示的属性更新 <AttributeTypeIdentifier>。