AcApProfileManager 类
这个类为访问“选项”对话框里“用户系统配置”标签中提供的所有的Profiles操作提供方法。
继承自
包含文件
acprofile.h
成员
AcApProfileManager::addReactor函数
virtual void
addReactor(
AcApProfileManagerReactor* unnamed) = 0;
|
unnamed |
输入要添加的AcApProfileManagerReactor |
这个函数添加一个反应器用来接收系统配置变化事件的通知。
AcApProfileManager::ProfileCopy函数
virtual Acad::ErrorStatus
ProfileCopy(
const char* newProfileName,
const char* oldProfileName,
const char* newProfileDesc) = 0;
|
newProfileName |
输入新的系统配置名称 |
|
oldProfileName |
输入要复制的系统配置名称 |
|
newProfileDesc |
输入新系统配置的类型 |
使用新的名称和类型建立新的系统配置。如果系统配置名称已经存在，它将被覆盖（如果它不是当前的系统配置）。旧系统配置里的ACAD设置将被复制到新的系统配置。
函数将用下列返回值返回：
|
Acad::eProfileDoesNotExist |
在注册表里找不到旧系统配置的名称. |
|
Acad::eInvalidProfileName |
新系统配置名称中有无效字符 |
|
Acad::eProfileIsInUse |
不能复制到当前的系统配置 |
|
Acad::eRegistryAccessError |
不能访问注册表 |
|
Acad::eOk |
操作成功完成 |
AcApProfileManager::ProfileDelete函数
virtual Acad::ErrorStatus
ProfileDelete(
const char* strProfileName) = 0;
|
strProfileName |
输入的系统配置名称 |
删除注册表中在strProfileName中指定的系统配置。
函数将用下列返回值返回：
|
Acad::eProfileDoesNotExist |
注册表中找不到指定系统配置的名称 |
|
Acad::eProfileIsInUse |
不能删除当前的系统配置 |
|
Acad::eRegistryAccessError |
不能访问/刷新注册表 |
|
Acad::eOk |
操作成功完成 |
AcApProfileManager::ProfileExport函数
virtual Acad::ErrorStatus
ProfileExport(
const char* strProfileName,
const char* exportFileName) = 0;
|
strProfileName |
输入的系统配置名称 |
|
exportFileName |
输出的.arg文件的名称 |
为指定的系统配置在注册表中的ACAD设置：strProfileName是被写出到.arg文件；exportFileName在REGEDIT4格式中。
函数将用下列返回值返回：
|
Acad::eProfileDoesNotExist |
注册表中找不到指定系统配置的名称 |
|
Acad::eNoFileName |
没有指定的文件名称 |
|
Acad::eInvalidFileExtension |
文件应该含有.arg扩展名 |
|
Acad::eCantOpenFile |
文件允许错误 |
|
Acad::eRegistryAccessError |
不能访问/刷新注册表 |
|
Acad::eOk |
操作成功完成 |
AcApProfileManager::ProfileImport函数
virtual Acad::ErrorStatus
ProfileImport(
const char* strProfileName,
const char* importFileName,
const char* profileDescription,
Adesk::Boolean bImportPathInfo)
= 0;
|
strProfileName |
输入的系统配置名称 |
|
importFileName |
输入的.arg文件的名称 |
|
profileDescription |
输入的系统配置类型 |
|
bImportPathInfo |
输入的布尔值；表示是否读入或忽略路径信息 |
用指定的名称（strProfileName）和类型（profileDescription）建立新的系统配置。如果系统配置名称已经存在，它将被覆盖（如果它不是当前的系统配置）。指定的.arg文件（importFileName）的ACAD设置将被读入到新系统配置的注册表中。bImportPathInfo决定是否读入或忽略文件里的路径信息。
函数将用下列返回值返回：
|
Acad::eInvalidProfileName |
系统配置名称中有无效字符 |
|
Acad::eNoFileName |
没有指定的文件名称 |
|
Acad::eInvalidFileExtension |
文件应该含有.arg扩展名 |
|
Acad::eProfileIsInUse |
不能进入当前的系统配置 |
|
Acad::eCantOpenFile |
文件允许错误 |
|
Acad::eRegistryCreateError |
不能刷新注册表 |
|
Acad::eRegistryAccessError |
不能访问注册表 |
|
Acad::eOk |
操作成功完成 |
AcApProfileManager::ProfileListNames函数
virtual int
ProfileListNames(
AcApProfileNameArray& nameList)
= 0;
|
nameList |
传入的AcApProfileNameArray |
这个函数据由AcApProfileNameArray返回系统配置名称列表（nameList）。传入时这个数组应该是空的。调用者应自行删除数组中的记录。
返回注册表中系统配置的数量。
AcApProfileManager::ProfileRegistryKey函数
virtual void
ProfileRegistryKey(
char*& strRegProfileKey,
const char* strProfileName) = 0;
|
strRegProfileKey |
输出注册表路径 |
|
strProfileName |
输入系统配置的名称 |
指定系统配置（strProfileName）的注册表路径是由strRegProfileKey返回的，如果在注册表里找到系统配置的名称。
如果返回一个空的值，调用者应自行分配存储单元给strRegProfileKey。
AcApProfileManager::ProfileRename函数
virtual Acad::ErrorStatus
ProfileRename(
const char* newProfileName,
const char* oldProfileName,
const char* newProfileDesc) = 0;
|
newProfileName |
输入新的系统配置名称 |
|
oldProfileName |
输入要复制的系统配置名称 |
|
newProfileDesc |
输入新系统配置的类型 |
使用新的类型（newProfileDesc）重命名已存在的系统配置名称（oldProfileName）为新的名称（newProfileName）。
函数将用下列返回值返回：
|
Acad::eProfileDoesNotExist |
在注册表里找不到指定的系统配置名称. |
|
Acad::eInvalidProfileName |
新系统配置名称中有无效字符 |
|
Acad::eProfileIsInUse |
不能重命名当前的系统配置名称. |
|
Acad::eRegistryAccessError |
不能访问/刷新注册表. |
|
Acad::eOk |
操作成功完成. |
AcApProfileManager::ProfileReset函数
virtual Acad::ErrorStatus
ProfileReset(
const char* strProfileName) = 0;
|
strProfileName |
输入的系统配置名称 |
在系统配置（strProfileName）下的设置被删除并系统配置恢复默认的设置。
函数将用下列返回值返回：
|
Acad::eProfileDoesNotExist |
在注册表里找不到指定的系统配置名称. |
|
Acad::eRegistryAccessError |
不能访问/更新注册表. |
|
Acad::eOk |
操作成功完成. |
AcApProfileManager::ProfileSetCurrent函数
virtual Acad::ErrorStatus
ProfileSetCurrent(
const char* strProfileName) = 0;
|
strProfileName |
输入的系统配置名称 |
指定的系统配置(strprofileName)被作为ACAD工作区间的当前系统配置。
函数将用下列返回值返回：
|
Acad::eProfileDoesNotExist |
在注册表里找不到指定的系统配置名称 |
|
Acad::eRegistryAccessError |
不能访问/更新注册表 |
|
Acad::eOk |
操作成功完成 |
AcApProfileManager::removeReactor函数
virtual void
removeReactor(
AcApProfileManagerReactor* unnamed) = 0;
|
unnamed |
输入要删除的AcApProfileManagerReactor对象 |
这个函数删除一个反应器。