ITcVnContainer

Offers an interface for an object container.

Inheritance Hierarchy

ITcUnknown
    ITcVnContainer

ITcVnContainer 1: Methods

Name

Origin

Description

TcAddRef

ITcUnknown

Increments the reference counter.

TcQueryInterface

ITcUnknown

Get a reference to an implemented interface.

TcRelease

ITcUnknown

Decrements the reference counter.

CheckIfBasicContainer

ITcVnContainer

Checks if the container contains only basic (non-container) elements.

CheckIfEmpty

ITcVnContainer

Checks if the container is empty. (Alternatively use F_VN_CheckIfEmpty.)

GetBidirectionalIterator

ITcVnContainer

Gets an interface pointer to a bidirectional iterator (if this iterator type is supported by the container) and increment its reference counter.

GetElementNum

ITcVnContainer

Gets the size (number of elements) of the container. (Alternatively use F_VN_GetNumberOfElements.)

GetElementSize

ITcVnContainer

Gets the size (in byte) of each element in the container.

GetElementTypeGuid

ITcVnContainer

Gets the GUID of the container elements.

GetExportSize

ITcVnContainer

Gets combined size (in byte) of all elements in the container.

GetForwardIterator

ITcVnContainer

Gets an interface pointer to a forward iterator (if this iterator type is supported by the container) and increment its reference counter. (Alternatively use F_VN_GetForwardIterator.)

GetRandomAccessIterator

ITcVnContainer

Gets an interface pointer to a random access iterator (if this iterator type is supported by the container) and increment its reference counter. (Alternatively use F_VN_GetRandomAccessIterator.)

GetTypeGuid

ITcVnContainer

Gets GUID of the container.

GetTypeName

ITcVnContainer

Gets the container type name as a string.

Weiterführende Informationen

Das Interface ITcVnContainer dient zur Handhabung von Containern. Beachten Sie die Hinweise im Kapitel Interface Pointer.

ITcVnContainer 2:

Überschreiben von Containern

Grundsätzlich können Container mit API-Funktionen einfach überschrieben werden. Zurzeit ist ein Überschreiben allerdings nicht möglich, wenn der existierende Container und der zu schreibende Container abweichende Typen haben. Dies wird durch den Fehlercode 70E (INCOMPATIBLE) signalisiert.

Verwandte Funktionen

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1. 4024.44 or later

PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision