Skip to main content

库: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 返回作为给定实例的祖先的顶级模块。