User Control

Ein User Control ist eine wiederverwendbare Sammlung von Controls, die nach der Erstellung wie ein Standard-Control in der Toolbox verfügbar ist. Ein User Control wird innerhalb des Projektbaums mit dem Kontextmenü Add new Item… erstellt.

	Beim Hinzufügen eines User Controls wird ein User Control Host erstellt, welches auf das User Control verweist. Daher wirkt jede Änderung eines Attributs (beispielsweise der Hintergrundfarbe) von außen auf den User Control Host und von innen auf das User Control.

Attribute

Kategorie: Colors

Name	Beschreibung
BackgroundColor	Definition der Hintergrundfarbe
BorderColor	Definition der Rahmenfarbe des Controls

Kategorie: Layout

Name	Beschreibung
Left	Definition des Abstands der linken Seite zur linken Seite des umschließenden Controls
LeftUnit	Definition der Einheit des Abstands zur rechten Seite des umschließenden Controls: Pixel für eine absolute Positionierung Prozent für eine relative Positionierung
Top	Definition des Abstands der oberen Seite zur oberen Seite des umschließenden Controls
TopUnit	Auswahl der Einheit des Abstands zur oberen Seite des umschließenden Controls: Pixel für eine absolute Positionierung Prozent für eine relative Positionierung
Right	Definition des Abstands der rechten Seite zur rechten Seite des umschließenden Controls
RightUnit	Auswahl der Einheit des Abstands zur rechten Seite des umschließenden Controls: Pixel für eine absolute Positionierung Prozent für eine relative Positionierung
Bottom	Definition des Abstands der unteren Seite zur unteren Seite des umschließenden Controls
BottomUnit	Auswahl der Einheit des Abstands zur unteren Seite des umschließenden Controls: Pixel für eine absolute Positionierung Prozent für eine relative Positionierung
Width	Definition der äußeren Breite des Controls
WidthUnit	Auswahl der Einheit der Breite: Pixel für eine absolute Breite Prozent für eine relative Breite
Height	Definition der äußere Höhe des Controls
HeightUnit	Auswahl der Einheit der Höhe: Pixel für eine absolute Höhe Prozent für eine relative Höhe
MaxWidth	Definition der maximalen Breite, wenn die Control-Größe dynamisch definiert ist.
MaxWidthUnit	Auswahl der Einheit der maximalen Breite: Pixel für einen absoluten Wert Prozent für einen relativen Wert
MinWidth	Definition der minimalen Breite, wenn die Control-Größe dynamisch definiert ist.
MinWidthUnit	Auswahl der Einheit der minimalen Breite: Pixel für einen absoluten Wert Prozent für einen relativen Wert
MaxHeight	Definition der maximalen Höhe, wenn die Control-Größe dynamisch definiert ist.
MaxHeightUnit	Auswahl der Einheit der maximalen Höhe: Pixel für einen absoluten Wert Prozent für einen relativen Wert
MinHeight	Definition der minimalen Höhe, wenn die Control-Größe dynamisch definiert ist.
MinHeightUnit	Auswahl der Einheit der minimalen Höhe: Pixel für einen absoluten Wert Prozent für einen relativen Wert
RenderedLeft	Berechneter Pixel-Abstand der linken Seite zur linken Seite des umschließenden Controls
RenderedTop	Berechneter Pixel-Abstand der oberen Seite zur oberen Seite des umschließenden Controls
RenderedRight	Berechneter Pixel-Abstand der rechten Seite zur rechten Seite des umschließenden Controls
RenderedBottom	Berechneter Pixel-Abstand der unteren Seite zur unteren Seite des umschließenden Controls
RenderedWidth	Berechnete Pixel-Breite des Controls
RenderedHeight	Berechnete Pixel-Höhe des Controls
GridRowIndex	Definition der Zeile eines Grids, in der das Control dargestellt werden soll.
GridColumnIndex	Definition der Spalte eines Grids, in der das Control dargestellt werden soll.
Opacity	Definition der Transparenz des ganzen Controls
Visibility	Auswahl der Sichtbarkeit eines Controls: Visible: Control ist sichtbar. Hidden: Control ist unsichtbar, wird aber gezeichnet – Controls dahinter sind nicht bedienbar. Collapsed: Control ist unsichtbar und wird nicht gezeichnet – Controls dahinter sind bedienbar.
ZIndex	Definition der Position auf der Z-Achse
Transform	Definition einer Transformation eines Controls: Translate: Verschieben in X-, Y-, Z-Richtung Rotate: Drehen um einen Winkel Scale: Zoomen um einen Faktor Skew: Schräges Darstellen der Seiten um einen Winkel Origin: Setzen des Ursprungs der Transformation relativ zur Position des Controls Perspective: Setzen der Perspektive der Transformationen aller Kindelemente
BoxShadow	Definition eines Schattens
WidthMode	Auswahl der Methode zur Berechnung der Breite: Value: Die Breite wird durch die eingetragene Breite definiert. Parent: Die Breite wird durch den Abstand zur linken und rechten Seite des Elternelements definiert. Das Attribut ‚Width‘ wird in allen Berechnungen ignoriert! Content: Die Höhe wird durch die Breite des Inhalts definiert. Das Attribut ‚Width‘ wird in allen Berechnungen ignoriert!
HeightMode	Auswahl der Methode zur Berechnung der Höhe: Value: Die Höhe wird durch die eingetragene Höhe definiert. Parent: Die Höhe wird durch den Abstand zur oberen und unteren Seite des Elternelements definiert. Das Attribut ‚Height‘ wird in allen Berechnungen ignoriert! Content: Die Höhe wird durch Höhe des Inhalts definiert. Das Attribut ‚Height‘ wird in allen Berechnungen ignoriert!

Kategorie: Common

Name	Beschreibung
IsEnabled	Auswahl, ob das Control aktiviert ist.
Id	Definition des Namens des Control
Type	Typname des Controls
ClassNames	Definition von Control Klassen
IsAttached	Es ist ein Control logisch im DOM eingehangen.
Tooltip	Definition des Tooltips für das Control

Kategorie: Border

Name	Beschreibung
BorderRadius	Definition des Radius der vier Ecken, um diese abzurunden
BorderStyle	Auswahl des Rahmenstils der vier Seiten des Controls
BorderWidth	Definition der Rahmenbreite der vier Seiten des Controls

Kategorie: Background Image

Name	Beschreibung
BackgroundImage	Definition eines Bildes, welches oberhalb der Hintergrundfarbe liegt
BackgroundImageHeight	Definition der Höhe des Hintergrundbildes
BackgroundImageHeightUnit	Auswahl der Einheit der Höhe des Hintergrundbildes: Pixel für eine absolute Höhe Prozent für eine relative Höhe
BackgroundImageWidth	Definition der Breite des Hintergrundbildes
BackgroundImageWidthUnit	Auswahl der Einheit der Breite des Hintergrundbildes: Pixel für eine absolute Breite Prozent für eine relative Breite
BackgroundImagePadding	Definition eines zusätzlichen Abstands zwischen dem Rahmen des Controls und dem Hintergrundbild für die vier Seiten
BackgroundImageVerticalAlignment	Definition der vertikalen Ausrichtung des Hintergrundbildes innerhalb des Controls
BackgroundImageHorizontalAlignment	Definition der horizontalen Ausrichtung des Hintergrundbildes innerhalb des Controls

Ereignisse

Kategorie: Framework

Name	Beschreibung
onAttached	Das Control wurde zur Anzeige hinzugefügt.
onDetached	Das Control wurde aus der Anzeige genommen.
onInitialized	Das Control wurde initialisiert.
onDestroyed	Das Control wurde zerstört.
onMoved	Das Control wurde bezogen auf das Browserfenster bewegt.
onResized	Das Control wurde in seiner Größe verändert.

Kategorie: Operator

Name	Beschreibung
onPressed	Es wurde per Maus geklickt oder ein Touchbildschirm kurz berührt.
onMouseClick	Die linke Maustaste wurde über dem Control gedrückt und losgelassen.
onMouseDoubleClick	Die linke Maustaste wurde zweimal über dem Control gedrückt und losgelassen.
onMouseRightClick	Die rechte Maustaste wurde über dem Control gedrückt und losgelassen.
onMouseDown	Eine Maustaste wurde über dem Control heruntergedrückt.
onMouseEnter	Der Mauszeiger wurde über das Control bewegt.
onMouseLeave	Der Mauszeiger hat das Control verlassen.
onMouseUp	Eine Maustaste wurde über dem Control losgelassen.
onMouseDownLeft	Die linke Maustaste wurde über dem Control heruntergedrückt.
onMouseDownRight	Die rechte Maustaste wurde über dem Control heruntergedrückt.
onMouseMove	Die Maus wurde über dem Control bewegt.
onMouseOver	Der Mauszeiger wurde über das Control oder eines seiner Kinder bewegt.
onMouseOut	Der Mauszeiger hat das Control oder eines seiner Kind-Controls verlassen.
onMouseUpLeft	Die linke Maustaste wurde über dem Control losgelassen.
onMouseUpRight	Die rechte Maustaste wurde über dem Control losgelassen.
onMouseWheel	Das Mausrad wurde über dem Control bewegt.
onTouchStart	Ein Finger/Stift wurde auf ein Touchbildschirm abgesetzt.
onTouchMove	Ein Finger/Stift wurde auf einem Touchbildschirm bewegt.
onTouchEnd	Ein Finger/Stift wurde von einem Touchbildschirm genommen.
onTouchCancel	Eine Interaktion mit einem Touchbildschirm wurde abgebrochen.

Zugriffsrechte

Name	Beschreibung
observe	Legt fest, ob das Control allgemein beobachtbar ist.
operate	Legt fest, ob das Control allgemein bedienbar ist.

Vererbungshierarchie

Control

Container Control

Partial

User Control

NuGet Paket: Beckhoff.TwinCAT.HMI.Framework

	NuGet-Pakete sind verfügbar ab Version 1.12.

	Verfügbar ab Version 1.10

Siehe auch

API-Referenz dieses Controls