Skip to main content

ライブラリ: AC_ModuleBase

モジュールベースライブラリはモジュールコンセプトの一部です CODESYS Application Composer。モジュール ツリー コンフィギュレータでユーザーが使用できるすべてのモジュールは、この基本ライブラリから派生する必要があります。

インスタンス名

モジュールの基本クラスにはプロパティ (get) があります。 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: 指定されたモジュール インスタンスの親インスタンスを返します。最初の最上位モジュール ノードの場合、戻り値は 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、指定されたインスタンスが関連付けられているトップレベルのモジュールを返します。