ITcSmTreeItem

Jedes Tree item in einer TwinCAT XAE Konfiguration wird mit Hilfe einer Instanz der ITcSmTreeItem-Klasse dargestellt, welche verschiedene Interaktionen mit dem Tree Item ermöglicht.

Ein Tree Item dieser Schnittstelle wird z.B. beim Aufruf der ITCatSysManager::LookupTreeItem-Methode zurückgegeben, welches dann zum Navigieren durch die Baumstruktur verwendet wird.

Eigenschaften

ITcSmTreeItem-Properties	Typ	Zugriff	Beschreibung
Name	BSTR	RW	Name des Tree Items
Comment	BSTR	RW	Kommentar
Disabled	BOOL	RW	Abrufen / Setzen des Zustands eines Tree Items, welcher einem der folgenden Aufzählwerte entsprechen kann: SMDS_NOT_DISABLED (Element ist aktiviert) SMDS_DISABLED (Element ist deaktiviert) SMDS_PARENT_DISABLED (schreibgeschützt, gesetzt, wenn eines seiner übergeordneten Elemente deaktiviert ist)
PathName	BSTR	R	Pfad des Tree Items in TwinCAT XAE. Die Zweige werden durch '^' getrennt. Der Pfadname kann in anderen Methoden, wie z.B. ITCatSysManager::LookupTreeItem verwendet werden. Beachten Sie, dass diese Eigenschaft ein Tree Item in TwinCAT XAE eindeutig identifiziert.
ItemType	ENUM	R	Kategorisierung eines Tree Items, z.B. Geräte, Boxen, SPS, ... . Wie mittels Item Types festgelegt.
ItemSubType	LONG	RW	Subtyp eines Tree Items.
Parent	ITcSmTreeItem*	R	Zeiger auf das übergeordnete Tree Item.
ChildCount	LONG	R	Anzahl untergeordneter Elemente. Diese Eigenschaft zählt lediglich untergeordnete Hauptelemente des Tree Items (z.B. Boxen sind untergeordnete Hauptelemente von einem Gerät, aber nicht das Geräteprozessabbild). Um auf alle untergeordneten Elemente zuzugreifen, verwenden Sie die Eigenschaft _NewEnum.
Child(LONG n)	ITcSmTreeItem*	R	ITcSmTreeItem Zeiger auf das n-te untergeordnete Element
VarCount((LONG x)	LONG	R	Anzahl der zum Tree Item zugehörigen Variablen. x = 0 Zählung der Eingangsvariablen, x = 1 Ausgangsvariablen
Var(LONG x, LONG n)	ITcSmTreeItem*	R	ITcSmTreeItem Zeiger auf die n-te Variable. x = 0 verwendet die Eingangsvariablen, x = 1 Ausgangsvariablen
_NewEnum	IUnknown* (IEnumVariant*)	R	Gibt eine Aufzählungsschnittstelle zurück, die alle untergeordneten Tree Items des aktuellen Tree Items aufzählt. Diese Eigenschaft kann z.B. bei einer For-Each Anweisung verwendet werden.

Methoden

ITcSmTreeItem-Methoden	Beschreibung	Verfügbar seit
CreateChild	Erzeugt ein untergeordnetes Tree Item.	TwinCAT 2.11
DeleteChild	Löscht ein untergeordnetes Tree Item.	TwinCAT 2.11
ImportChild	Importiert ein untergeordnetes Tree Item aus der Zwischenablage oder einer zuvor exportierten Datei.	TwinCAT 2.11
ExportChild	Exportiert ein untergeordnetes Tree Item in die Zwischenablage oder in eine Datei.	TwinCAT 2.11
ProduceXml	Gibt eine Zeichenkette mit der XML-Darstellung eines Elements zurück, mitsamt dessen elementspezifischen Daten und Parametern.	TwinCAT 2.11
ConsumeXml	Verwendet eine Zeichenkette mit der XML-Darstellung eines Tree Items, mitsamt dessen elementspezifischen Daten und Parametern.	TwinCAT 2.11
GetLastXmlError	Ruft die Fehlermeldung des letzten gescheiterten ConsumeXml()-Aufrufs ab.	TwinCAT 2.11
LookupChild	Suche nach einem untergeordneten Element mit dem angegebenen relativen Pfad.	TwinCAT 2.11

ITcSmTreeItem2-Methoden	Beschreibung	Verfügbar seit
ResoucesCount	Nur für internen Gebrauch	TwinCAT 2.11
ChangeChildSubType	Ändert den Subtyp von ITcSmTreeItem.	TwinCAT 2.11
ClaimResources	Nur für internen Gebrauch	TwinCAT 2.11

Versionsinformationen

Voraussetzungen

Erforderliche TwinCAT Version
Diese Schnittstelle wird ab TwinCAT 2.11 unterstützt.