库:AC_ModuleBase
模块基础库AC_ModuleBase是模块概念的一部分 CODESYS Application Composer。开发为可在模块树配置器中使用的所有模块都必须从此基本库派生。
实例名称
该物业 InstanceName
基类的返回一个包含模块实例名称的字符串。
财产在 IInstanceBase
:PROPERTY InstanceName : STRING(255)
返回值:模块实例的实例名称
提示
代理实例返回远程模块实例的实例名称。
模块信息
PROPERTY ModuleInfo : POINTER TO ModuleInfo
:该属性返回一个指向带有方法的 ModuleInfo 功能块的指针 PROPERTY ModuleType : STRING(255)
。
PROPERTY ModuleType : STRING(255)
:此属性返回由模块库的名称空间限定的模块名称。 (名称空间与主项目相关。)
实例路径
功能 GetInstancePath(IModule)
返回模块实例的实例路径。实例路径是通过连接所有祖先的实例名称来构建的,从顶层模块开始一直到给定的实例。实例名称由点分隔。如果生成的实例名称超过 255 个字符,则返回空字符串。
PROPERTY InstancePath : STRING(255)
平面导航
功能 GetPrevModule(IModule)
和 GetNextModule(IModule)
允许跳转到上一个或下一个元素(如果模块树被视为模块实例的平面列表)。模块按模块树的深度优先预序返回。如果没有上一个或下一个模块,则跳过模块引用。
或者功能块 DepthFirstRange
可以使用它列出从特定实例开始的所有实例。功能 GetDepthFirstRange
返回范围函数块实例(类型为 DepthFirstRange
)它列出了从给定实例开始的完整树。
分层导航
界面 IModuleTree
允许在模块树中导航。通过使用指向类型实例的指针,向每个模块提供此接口的对象 MEnv
。这个指针被传递给函数 SetIdentification
。导航中会跳过模块引用。子节点的顺序对应于模块树中模块实例的顺序。
GetParent(itfM : IModule) : IModule
: IModule: 返回给定模块实例的父实例。对于顶级模块实例,返回值为 0。
GetFirstChild(itfM : IModule) : IModule
:返回给定模块实例的第一个子级。对于没有子级的模块实例,返回值为 0
NextSibling(itfM : IModule) : IModule
:返回模块实例的下一个同级。对于没有其他同级的模块实例,它返回 0。也可以为顶级实例调用它。
PrevSibling(itfM : IModule) : IModule
:返回模块实例的前一个同级。对于没有先前兄弟的模块实例,它返回 0。它也可以为顶级实例调用。
GetFirstToplevelInstance() : IModule
:返回树的第一个顶级实例。如果树为空,则返回 0。
导航至祖先、兄弟姐妹和孩子
功能块 AncestorRange
允许访问实例的所有祖先,从实例本身开始。功能块 SiblingRange
允许访问模块树中实例的所有后续同级实例,从实例本身开始。功能 GetChildRange
返回一个范围元素(类型 SiblingRange
) 实例的所有子级。
导航至顶层
功能 GetToplevelRange
返回一个范围实例(类型 SiblingRange
)它提供对所有顶级实例的访问。功能 GetToplevelInstance
返回作为给定实例的祖先的顶级模块。