create
[ Funktion ] [ Deprecated ]
public static create(
type: string,
id: string,
parent?: TcHmi.Controls.System.baseTcHmiControl | null
): TcHmi.Controls.System.baseTcHmiControl | undefined;Funktion zum programmatischen Erstellen von Control Instanzen, basierend auf der Typbezeichnung.
 | Ab Version 1.10 gilt diese Funktion als veraltet. Es wird die Verwendung der Funktion createEx empfohlen. |
Parameter
Name | Typ | Beschreibung |
|---|---|---|
type | Typ des neuen Controls. | |
id | Identifier des neuen Controls. | |
parent [ Optional ] | Eltern-Control des neuen Controls. Wird unter anderem genutzt zur Prüfung der Zugriffsrechte, wenn diese vom Eltern-Control abhängen.
Wird ein Control dynamisch auf Applikationsebene ( CodeBehind ) erstellt um es anschließend zu einem ContainerControl (View, Content, Container, etc.) hinzuzufügen ist dieser Parameter nicht zu setzen. Die Eltern-Kind-Beziehung wird dynamisch hergestellt, wenn das Control per addChild Funktion zum entsprechenden ContainerControl hinzugefügt wird.
Wird ein Control dynamisch innerhalb eines anderen Controls erstellt so ist dieses andere Control das logische Eltern-Control und muss bei der Erstellung des neuen Controls übergeben werden, damit Eigenschaften wie Zugriffsrechte auch auf dieses Kind-Control wirken können und das System die Möglichkeit hat dieses Kind-Control zu zerstören, wenn das Eltern-Control zerstört wird. |
Rückgabewert
Typ | Beschreibung |
|---|---|
Das Control-Objekt oder |
| Verfügbar ab Version 1.8 |
Beispiel – TypeScript
In diesem Beispiel wird ein Button innerhalb eines eigenen Controls dynamisch erzeugt und in den DOM hinzugefügt.
// Place in __prevInit of your own control:
var myButton = TcHmi.ControlFactory.create<TcHmi.Controls.Beckhoff.TcHmiButton>
(
'TcHmi.Controls.Beckhoff.TcHmiButton',
'MyButton',
this // <- this sets the framework parent/child relationship,
// but does not add it in the DOM
);
if (!myButton) {
// handle error
throw new Error(this.getId() + ': Could not create sub button');
}
// Add the button to the DOM at a specific position
this.getElement().append(myButton.getElement());