UIElement Klasse

Definition

Namespace:: Microsoft.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

UIElement ist eine Basisklasse für die meisten Windows Runtime UI-Objekte mit visuellem Erscheinungsbild und kann grundlegende Eingaben als Teil der Benutzeroberfläche Ihrer App verarbeiten.

public ref class UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2

Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject, IVisualElement, IVisualElement2

Vererbung: Object Platform::Object IInspectable DependencyObject UIElement

Abgeleitet: Microsoft.UI.Xaml.FrameworkElement

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert: IAnimationObject IVisualElement IVisualElement2

Hinweise

UIElement ist ein Basiselement: Es handelt sich um eine Klasse, von der viele andere Windows Runtime Klassen erben, um das XAML-UI-Elementmodell zu unterstützen. Eigenschaften, Methoden und Ereignisse, die UIElement definiert werden, werden von Hunderten anderer Windows Runtime Klassen geerbt.

UIElement macht keinen öffentlichen Konstruktor verfügbar. In der Regel leiten Sie klassen nicht direkt oder FrameworkElement abUIElement. In der Regel verwendete Basisklassen für abgeleitete benutzerdefinierte Klassen sind die folgenden Klassen:

Bestimmte Steuerelemente, die nicht versiegelt sind (z. B. TextBox)
Steuerelementbasisklassen (Control, ContentControl, UserControl)
Navigationselemente (Seite, Frame)
Panelklassen (die Basisklasse Panel oder bestimmte nicht versiegelte Implementierungen wie Grid)

Die klasse UIElement wird als Typparameter vieler Eigenschaften und Methoden in der Windows Runtime-API verwendet. Die Child-Eigenschaft von Border akzeptiert beispielsweise ein einzelnes UIElementElement, das das Element darstellt, um das der Rahmen gezeichnet wird. Sie können ein beliebiges abgeleitetes UIElementElement für eine solche Eigenschaft bereitstellen, einschließlich benutzerdefinierter Steuerelemente, die Sie definieren.

Die UIElementCollection-Klasse stellt eine stark typierte Auflistung von UIElement Elementen bereit. UIElementCollection wird als Typ für Eigenschaften von Objekten verwendet, die mehrere untergeordnete Elemente enthalten, z. B. für die Children-Eigenschaft einer beliebigen Panel-Klasse .

Uielement API und Features

UIElement erweitert DependencyObject, ein weiteres Basiselement, und bietet Unterstützung für verschiedene Windows Runtime Featurebereiche.

Eingaben und Ereignisse für die Reaktion auf Benutzerinteraktionen

Ein Großteil des Eingabeverhaltens für sichtbare Elemente in einer Benutzeroberfläche wird in der UIElement Klasse definiert. Dazu gehören die Ereignisse für Tastatur-, Maus-, Touch-, Drag-Drop- und Fokusinteraktionen. Weitere Informationen finden Sie unter Behandeln von Zeigereingaben, Tastaturinteraktionen und benutzerdefinierten Benutzerinteraktionen.

Prominente API, die UIElement Eingabe- und Benutzerinteraktion unterstützt:

Zeigerereignisse:PointerPressed, PointerReleased, PointerMoved, PointerEntered, PointerExited
Schlüsselbehandlungsereignisse:KeyDown, KeyUp
Focus:GotFocus, LostFocus
Zeigeraufnahme:CapturePointer, PointerCanceled, PointerCaptureLost, ReleasePointerCapture, PointerCaptures
Drag-drop:DragOver, Drop, DragEnter, DragLeave, AllowDrop
Eigenschaften, die beeinflussen, wie grundlegende Eingaben verarbeitet werden:IsHitTestVisible, AllowDrop

Gesten und Manipulationen

Gesten und Manipulationen sind auch eine Möglichkeit zum Behandeln von Eingabe- und Benutzerinteraktionen. Die API wird hier separat aufgeführt, da diese Ereignisse darstellen, wie das System mit Eingabeaktionen auf Geräteebene interagiert und als Benutzerinteraktion interpretiert. Manipulationen sind eine Möglichkeit, dynamische Multitouchinteraktionen wie Zusammendrücken und Strecken zu verarbeiten. Zusammen bieten die Gesten und Manipulationen die Touchmuster für die Touchinteraktion mit der UWP-App. Weitere Informationen finden Sie unter Benutzerdefinierte Benutzerinteraktionen und Touchinteraktionsdesign.

Prominente API für UIElement diese Unterstützung von Gesten und Manipulationen:

Gestikereignisse:DoubleTapped, Halten, RightTapped, Getippt
Manipulationsereignisse:ManipulationCompleted, ManipulationDelta, ManipulationInertiaStarting, ManipulationStarted, ManipulationStarting
Eigenschaften, die beeinflussen, wie Gesten und Manipulationen verarbeitet werden:IsHoldingEnabled und andere Is*Enabled, ManipulationMode

Grundlegende Darstellung

Die Eigenschaften "Sichtbarkeit" und "Deckkraft " werden häufig verwendet, um das Erscheinungsbild eines Elements in der Benutzeroberfläche anzupassen, insbesondere innerhalb von Formatvorlagen, Vorlagen und visuellen Zuständen. Die Eigenschaften "Clip", "RenderTransform" und "Transitions " sind jeweils nützlich, um Interaktionen zu erzeugen und unterschiedliche Designs für Ihre UI-Elemente zu suchen.

Einfaches Layout

Die UIElement Klasse stellt einen Ausgangspunkt für Layoutmerkmale mit Eigenschaften wie DesiredSize und den Arrange - und Measure-Methoden bereit. FrameworkElement fügt weitere Layoutfunktionen hinzu. Weitere Informationen finden Sie unter Definieren von Layouts mit XAML und FrameworkElement.

Routingereignisse

Die meisten Eingabeereignisse von RoutingereignissenUIElement sind Routingereignisse. Ein routingfähiges Ereignis ermöglicht ein integriertes Benachrichtigungssystem für die Ereignisbehandlung, sodass ein übergeordnetes Objekt Eingabeereignisse von untergeordneten Objekten in der Objektstruktur verarbeiten kann, wenn das Ereignis nicht behandelt wird. Dieses Eingabeereignisverhalten ist nützlich für die Gruppierung des Eingabebereichs und für die Steuerungskompositionen. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Prominente API, die UIElement Routingereignisse unterstützt: AddHandler, RemoveHandler, *Event-Eigenschaften .

Andere Plattformunterstützung

OnCreateAutomationPeer ermöglicht einer Klasse die Verwendung eines benutzerdefinierten AutomationPeer für die Microsoft UI Automation Unterstützung.
RenderTransform, TransformToVisual, Projection, CompositeMode, CacheMode und FindSubElementsForTouchTargeting sind nützlich für erweiterte UI-Layoutszenarien.

UIElement-Abhängigkeitseigenschaften

Viele der Lese-/Schreibeigenschaften der UIElement Basiselementklasse sind Abhängigkeitseigenschaften. Abhängigkeitseigenschaften unterstützen einige der grundlegenden Programmiermodellfeatures für eine App mit C++ oder C#, z. B. Stile und Vorlagen, Datenbindung, XAML-Ressourcenverweise und Eigenschaftsänderungslogik. Weitere Informationen zu Abhängigkeitseigenschaften und den unterstützten Features finden Sie in der Übersicht über Abhängigkeitseigenschaften.

VON UIElement abgeleitete Klassen

Die einzige Windows Runtime Klasse, die direkt von UIElement abgeleitet wird, ist FrameworkElement. Eine Liste der Klassen, die von FrameworkElement abgeleitet werden, finden Sie im Abschnitt "FrameworkElement derived classes" des FrameworkElement-Referenzthemas.

Eigenschaften

Name	Beschreibung
AccessKey	Dient zum Abrufen oder Festlegen der Zugriffstaste (Mnemonic) für dieses Element.
AccessKeyProperty	Identifies for the AccessKey dependency property.
AccessKeyScopeOwner	Dient zum Abrufen oder Festlegen eines Quellelements, das den Zugriffstastenbereich für dieses Element bereitstellt, auch wenn es sich nicht in der visuellen Struktur des Quellelements befindet.
AccessKeyScopeOwnerProperty	Identifies for the AccessKeyScopeOwner dependency property.
ActualOffset	Ruft die Position dieses UIElements relativ zum übergeordneten Element ab, das während des Anordnungsdurchlaufs des Layoutprozesses berechnet wird.
ActualSize	Ruft die Größe ab, die dieses UIElement während des Anordnungsdurchlaufs des Layoutprozesses berechnet wurde.
AllowDrop	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob dieses UIElement ein Drop-Ziel für Drag-and-Drop-Vorgänge sein kann.
AllowDropProperty	Identifies the AllowDrop dependency property.
BringIntoViewRequestedEvent	Ruft den Bezeichner für das BringIntoViewRequested-Routingereignis ab.
CacheMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, dass gerenderter Inhalt nach Möglichkeit als zusammengesetzte Bitmap zwischengespeichert werden soll.
CacheModeProperty	Identifies the CacheMode dependency property.
CanBeScrollAnchor	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das UIElement ein Kandidat für die Bildlaufankerung sein kann.
CanBeScrollAnchorProperty	Identifies the CanBeScrollAnchor dependency property.
CanDrag	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element in einem Drag-and-Drop-Vorgang als Daten gezogen werden kann.
CanDragProperty	Identifies the CanDrag dependency property.
CenterPoint	Dient zum Abrufen oder Festlegen des Mittelpunkts des Elements, bei dem es sich um den Punkt handelt, an dem die Drehung oder Skalierung erfolgt. Wirkt sich auf die Renderingposition des Elements aus.
CharacterReceivedEvent	Ruft den Bezeichner für das CharacterReceived-Routingereignis ab.
Clip	Dient zum Abrufen oder Festlegen der RectangleGeometry-Eigenschaft , die zum Definieren der Gliederung des Inhalts eines UIElements verwendet wird.
ClipProperty	Identifies the Clip dependency property.
CompositeMode	Dient zum Abrufen oder Festlegen einer Eigenschaft, die alternative Kompositions- und Blendungsmodi für das Element im übergeordneten Layout und Fenster deklariert. Dies ist für Elemente relevant, die an einer gemischten XAML-/Microsoft DirectX-Benutzeroberfläche beteiligt sind.
CompositeModeProperty	Identifies the CompositeMode dependency property.
ContextFlyout	Ruft das flyout ab, das diesem Element zugeordnet ist, oder legt es fest.
ContextFlyoutProperty	Identifies for the ContextFlyout dependency property.
ContextRequestedEvent	Ruft den Bezeichner für das ContextRequested-Routingereignis ab.
DesiredSize	Ruft die Größe ab, die dieses UIElement während des Messdurchlaufs des Layoutprozesses berechnet hat.
Dispatcher	Gibt immer in einer Windows App SDK-App zurück `null` . Verwenden Sie stattdessen DispatcherQueue . (Geerbt von DependencyObject)
DispatcherQueue	Ruft ab `DispatcherQueue` , dem dieses Objekt zugeordnet ist. Dies `DispatcherQueue` stellt eine Einrichtung dar, die auf den `DependencyObject` UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
DoubleTappedEvent	Ruft den Bezeichner für das DoubleTapped-Routingereignis ab.
DragEnterEvent	Ruft den Bezeichner für das DragEnter routingd -Ereignis ab.
DragLeaveEvent	Ruft den Bezeichner für das DragLeave-Routingereignis ab.
DragOverEvent	Ruft den Bezeichner für das DragOver-Routingereignis ab.
DropEvent	Ruft den Bezeichner für das Drop-Routingereignis ab.
ExitDisplayModeOnAccessKeyInvoked	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zugriffstastenanzeige geschlossen wird, wenn eine Zugriffstaste aufgerufen wird.
ExitDisplayModeOnAccessKeyInvokedProperty	Identifies the ExitDisplayModeOnAccessKeyInvoked dependency property.
FocusState	Ruft einen Wert ab, der angibt, ob dieses Steuerelement den Fokus hat, und den Modus, mit dem der Fokus abgerufen wurde.
FocusStateProperty	Identifies the FocusState dependency property.
GettingFocusEvent	Ruft den Bezeichner für das GettingFocus-Routingereignis ab.
HighContrastAdjustment	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Framework die visuellen Eigenschaften des Elements automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind.
HighContrastAdjustmentProperty	Identifies the HighContrastAdjustment dependency property.
HoldingEvent	Ruft den Bezeichner für das Routingereignis "Holding " ab.
IsAccessKeyScope	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Element seinen eigenen Zugriffstastenbereich definiert.
IsAccessKeyScopeProperty	Identifies for the IsAccessKeyScope dependency property.
IsDoubleTapEnabled	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das DoubleTapped-Ereignis aus diesem Element stammen kann.
IsDoubleTapEnabledProperty	Identifies the IsDoubleTapEnabled dependency property.
IsHitTestVisible	Ruft ab oder legt fest, ob der enthaltene Bereich dieses UIElement true-Werte für Treffertests zurückgeben kann.
IsHitTestVisibleProperty	Identifies the IsHitTestVisible dependency property.
IsHoldingEnabled	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das Holding-Ereignis aus diesem Element stammen kann.
IsHoldingEnabledProperty	Identifies the IsHoldingEnabled dependency property.
IsRightTapEnabled	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das RightTapped-Ereignis aus diesem Element stammen kann.
IsRightTapEnabledProperty	Identifies the IsRightTapEnabled dependency property.
IsTabStop	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Steuerelement in der Registerkartennavigation enthalten ist.
IsTabStopProperty	Identifies the UIElement.IsTabStop dependency property.
IsTapEnabled	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das Tapped-Ereignis aus diesem Element stammen kann.
IsTapEnabledProperty	Identifies the IsTapEnabled dependency property.
KeyboardAcceleratorPlacementMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die QuickInfo des Steuerelements die Tastenkombination für die zugehörige Zugriffstaste anzeigt.
KeyboardAcceleratorPlacementModeProperty	Identifies the KeyboardAcceleratorPlacementMode dependency property.
KeyboardAcceleratorPlacementTarget	Dient zum Abrufen oder Festlegen eines Werts, der die QuickInfo des Steuerelements angibt, die die Tastenkombination für die Tastenkombination anzeigt.
KeyboardAcceleratorPlacementTargetProperty	Identifies the KeyboardAcceleratorPlacementTarget dependency property.
KeyboardAccelerators	Ruft die Auflistung von Tastenkombinationen ab, die eine Aktion mithilfe der Tastatur aufrufen. Zugriffstasten werden in der Regel Schaltflächen oder Menüelementen zugewiesen. Beispiel für ein Menü mit Zugriffstasten für verschiedene Menüelemente
KeyDownEvent	Ruft den Bezeichner für das KeyDown-Routingereignis ab.
KeyTipHorizontalOffset	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie weit links oder rechts die Zugriffstasteninfo im Verhältnis zum UIElement platziert wird.
KeyTipHorizontalOffsetProperty	Identifies the KeyTipHorizontalOffset dependency property.
KeyTipPlacementMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wo die Zugriffstastentasteninfo in Bezug auf die Grenze des UIElement platziert wird.
KeyTipPlacementModeProperty	Identifies the KeyTipPlacementMode dependency property.
KeyTipTarget	Dient zum Abrufen oder Festlegen eines Werts, der das Element angibt, das von der Zugriffstastentasteninfo bestimmt wird.
KeyTipTargetProperty	Identifies the KeyTipTarget dependency property.
KeyTipVerticalOffset	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie weit nach oben oder unten die Zugriffstasteninfo im Verhältnis zum UI-Element platziert wird.
KeyTipVerticalOffsetProperty	Identifies the KeyTipVerticalOffset dependency property.
KeyUpEvent	Ruft den Bezeichner für das KeyUp-Routingereignis ab.
Lights	Ruft die Auflistung von XamlLight-Objekten ab, die diesem Element zugeordnet sind.
LightsProperty	Identifies the Lights dependency property.
LosingFocusEvent	Ruft den Bezeichner für das Routingereignis LosingFocus ab.
ManipulationCompletedEvent	Ruft den Bezeichner für das Routingereignis ManipulationCompleted ab.
ManipulationDeltaEvent	Ruft den Bezeichner für das Routingereignis ManipulationDelta ab.
ManipulationInertiaStartingEvent	Ruft den Bezeichner für das Routingereignis ManipulationInertiaStarting ab.
ManipulationMode	Dient zum Abrufen oder Festlegen des ManipulationModes-Werts , der für uiElement-Verhalten und Interaktion mit Gesten verwendet wird. Das Festlegen dieses Werts ermöglicht das Behandeln der Manipulationsereignisse aus diesem Element im App-Code.
ManipulationModeProperty	Identifies the ManipulationMode dependency property.
ManipulationStartedEvent	Ruft den Bezeichner für das Routingereignis ManipulationStarted ab.
ManipulationStartingEvent	Ruft den Bezeichner für das Routingereignis ManipulationStarting ab .
NoFocusCandidateFoundEvent	Ruft den Bezeichner für das Routingereignis NoFocusCandidateFound ab.
Opacity	Dient zum Abrufen oder Festlegen des Grads der Deckkraft des Objekts.
OpacityProperty	Identifies the IsHitTestVisible dependency property.
OpacityTransition	Dient zum Abrufen oder Festlegen der SkalarTransition, die Änderungen an der Opacity -Eigenschaft animiert.
PointerCanceledEvent	Ruft den Bezeichner für das PointerCanceled-Routingereignis ab.
PointerCaptureLostEvent	Ruft den Bezeichner für das PointerCaptureLost-Routingereignis ab.
PointerCaptures	Ruft den Satz aller erfassten Zeiger ab, dargestellt als Zeigerwerte .
PointerCapturesProperty	Identifies the PointerCaptures dependency property.
PointerEnteredEvent	Ruft den Bezeichner für das PointerEntered-Routingereignis ab.
PointerExitedEvent	Ruft den Bezeichner für das PointerExited-Routingereignis ab.
PointerMovedEvent	Ruft den Bezeichner für das PointerMoved-Routingereignis ab.
PointerPressedEvent	Ruft den Bezeichner für das PointerPressed-Routingereignis ab.
PointerReleasedEvent	Ruft den Bezeichner für das PointerReleased-Routingereignis ab.
PointerWheelChangedEvent	Ruft den Bezeichner für das PointerWheelChanged-Routingereignis ab.
PreviewKeyDownEvent	Ruft den Bezeichner für das PreviewKeyDown-Routingereignis ab.
PreviewKeyUpEvent	Ruft den Bezeichner für das PreviewKeyUp-Routingereignis ab.
Projection	Ruft die perspektivische Projektion (3D-Effekt) ab, die beim Rendern dieses Elements angewendet werden soll, oder legt diese fest.
ProjectionProperty	Identifies the Projection dependency property.
ProtectedCursor	Dient zum Abrufen oder Festlegen des Cursors, der angezeigt wird, wenn der Zeiger über diesem Element liegt. Der Standardwert ist NULL, der keine Änderung des Cursors angibt.
RasterizationScale	Ruft einen Wert ab, der einen zusätzlichen Skalierungsfaktor darstellt, der beim Rendern von Formen, Bildern, Text oder Medien verwendet werden soll, normalerweise um eine höhere Auflösung als normal zu rendern.
RenderSize	Ruft die endgültige Rendergröße eines UIElements ab. Die Verwendung wird nicht empfohlen. Weitere Informationen finden Sie in den Hinweisen.
RenderTransform	Dient zum Abrufen oder Festlegen von Transformationsinformationen, die sich auf die Renderingposition eines UIElements auswirken.
RenderTransformOrigin	Ruft den Ursprungspunkt einer möglichen Rendertransformation ab, die von RenderTransform deklariert wird, relativ zu den Grenzen des UIElements.
RenderTransformOriginProperty	Identifies the RenderTransformOrigin dependency property.
RenderTransformProperty	Identifies the RenderTransform dependency property.
RightTappedEvent	Ruft den Bezeichner für das RightTapped-Routingereignis ab.
Rotation	Ruft den Winkel der Drehung im Uhrzeigersinn in Grad ab oder legt den Winkel fest. Dreht sich relativ zu RotationAxis und CenterPoint. Wirkt sich auf die Renderingposition des Elements aus.
RotationAxis	Ruft die Achse ab, um die das Element gedreht werden soll, oder legt sie fest.
RotationTransition	Dient zum Abrufen oder Festlegen der ScalarTransition, die Änderungen an der Rotation -Eigenschaft animiert.
Scale	Dient zum Abrufen oder Festlegen der Skalierung des Elements. Skaliert relativ zum CenterPoint des Elements. Wirkt sich auf die Renderingposition des Elements aus.
ScaleTransition	Dient zum Abrufen oder Festlegen der Vector3Transition, die Änderungen an der Scale -Eigenschaft animiert.
Shadow	Dient zum Abrufen oder Festlegen des Schatteneffekts, der vom Element gegossen wird.
ShadowProperty	Identifies the Shadow dependency property.
TabFocusNavigation	Dient zum Abrufen oder Festlegen eines Werts, der die Funktionsweise von Tabbing und TabIndex für dieses Steuerelement ändert.
TabFocusNavigationProperty	Identifies the TabFocusNavigation dependency property.
TabIndex	Dient zum Abrufen oder Festlegen eines Werts, der die Reihenfolge bestimmt, in der Elemente den Fokus erhalten, wenn der Benutzer mithilfe der TAB-TASTE durch Steuerelemente navigiert.
TabIndexProperty	Identifies the TabIndex dependency property.
TappedEvent	Ruft den Bezeichner für das Getippte Routingereignis ab.
Transform3D	Ruft den 3D-Transformationseffekt ab, der beim Rendern dieses Elements angewendet werden soll, oder legt diesen fest.
Transform3DProperty	Identifies the Transform3D dependency property.
TransformMatrix	Dient zum Abrufen oder Festlegen der Transformationsmatrix, die auf das Element angewendet werden soll.
Transitions	Dient zum Abrufen oder Festlegen der Auflistung von Übergangsstilelementen , die auf ein UIElement angewendet werden.
TransitionsProperty	Identifies the Transitions dependency property.
Translation	Ruft die x-, y- und z-Renderingposition des Elements ab oder legt sie fest.
TranslationTransition	Dient zum Abrufen oder Festlegen der Vector3Transition, die Änderungen an der Translation -Eigenschaft animiert.
UseLayoutRounding	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das Rendern für das Objekt und dessen visuelle Unterstruktur ein Rundungsverhalten verwenden soll, das das Rendern auf ganze Pixel ausgerichtet.
UseLayoutRoundingProperty	Identifies the UseLayoutRounding dependency property.
UseSystemFocusVisuals	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Fokusvisuale verwendet, die vom System oder von fokus visuellen Elementen gezeichnet werden, die in der Steuerelementvorlage definiert sind.
UseSystemFocusVisualsProperty	Identifies the UseSystemFocusVisuals dependency property.
Visibility	Dient zum Abrufen oder Festlegen der Sichtbarkeit eines UIElements. Ein `UIElement` nicht sichtbarer Wert wird nicht gerendert und kommuniziert nicht seine gewünschte Größe mit dem Layout.
VisibilityProperty	Identifies the Visibility dependency property.
XamlRoot	Dient zum Abrufen oder Festlegen des `XamlRoot` Elements, in dem dieses Element angezeigt wird.
XYFocusDown	Ruft ab oder legt das Objekt fest, das den Fokus erhält, wenn ein Benutzer auf dem Directional Pad (D-Pad) eines Gamecontrollers nach unten drückt.
XYFocusDownNavigationStrategy	Dient zum Abrufen oder Festlegen eines Werts, der die Strategie angibt, mit der das Zielelement einer Abwärtsnavigation bestimmt wird.
XYFocusDownNavigationStrategyProperty	Identifies the XYFocusDownNavigationStrategy dependency property.
XYFocusDownProperty	Identifies the XYFocusDown dependency property.
XYFocusKeyboardNavigation	Dient zum Abrufen oder Festlegen eines Werts, der die Navigation mithilfe der Tastaturrichtungspfeile aktiviert oder deaktiviert.
XYFocusKeyboardNavigationProperty	Identifies the XYFocusKeyboardNavigation dependency property.
XYFocusLeft	Ruft ab oder legt das Objekt fest, das den Fokus erhält, wenn ein Benutzer auf dem Directional Pad (D-Pad) eines Gamecontrollers nach links drückt.
XYFocusLeftNavigationStrategy	Dient zum Abrufen oder Festlegen eines Werts, der die Strategie angibt, mit der das Zielelement einer linken Navigation bestimmt wird.
XYFocusLeftNavigationStrategyProperty	Identifies the XYFocusLeftNavigationStrategy dependency property.
XYFocusLeftProperty	Identifies the XYFocusLeft dependency property.
XYFocusRight	Ruft ab oder legt das Objekt fest, das den Fokus erhält, wenn ein Benutzer rechts auf das Directional Pad (D-Pad) eines Gamecontrollers drückt.
XYFocusRightNavigationStrategy	Dient zum Abrufen oder Festlegen eines Werts, der die Strategie angibt, mit der das Zielelement einer rechten Navigation bestimmt wird.
XYFocusRightNavigationStrategyProperty	Identifies the XYFocusRightNavigationStrategy dependency property.
XYFocusRightProperty	Identifies the XYFocusRight dependency property.
XYFocusUp	Ruft ab oder legt das Objekt fest, das den Fokus erhält, wenn ein Benutzer auf das Directional Pad (D-Pad) eines Gamecontrollers drückt.
XYFocusUpNavigationStrategy	Dient zum Abrufen oder Festlegen eines Werts, der die Strategie angibt, mit der das Zielelement einer up-Navigation bestimmt wird.
XYFocusUpNavigationStrategyProperty	Identifies the XYFocusUpNavigationStrategy dependency property.
XYFocusUpProperty	Identifies the XYFocusUp dependency property.

Methoden

Name	Beschreibung
AddHandler(RoutedEvent, Object, Boolean)	Fügt einen Routingereignishandler für ein angegebenes Routingereignis hinzu, und fügt den Handler der Handlerauflistung für das aktuelle Element hinzu. Geben Sie an `handledEventsToo` , dass `true` der bereitgestellte Handler aufgerufen werden soll, auch wenn das Ereignis an anderer Stelle behandelt wird.
Arrange(Rect)	Positioniert untergeordnete Objekte und bestimmt eine Größe für ein UIElement. Übergeordnete Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Elemente implementieren, sollten diese Methode aus ihren Layoutüberschreibungsimplementierungen aufrufen, um eine rekursive Layoutaktualisierung zu bilden.
CancelDirectManipulations()	Bricht die laufende direkte Manipulationsverarbeitung (systemdefiniertes Schwenken/Zoomen) auf jedem übergeordneten ScrollViewer-Element ab, das das aktuelle UIElement enthält.
CapturePointer(Pointer)	Legt die Zeigererfassung auf ein UIElement fest. Nach der Erfassung löst nur das Element, das erfasst wurde, Zeigerereignisse aus.
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
FindSubElementsForTouchTargeting(Point, Rect)	Aktiviert eine UIElement-Unterklasse , um untergeordnete Elemente verfügbar zu machen, die bei der Auflösung der Touchadressierung helfen.
Focus(FocusState)	Versucht, den Fokus auf dieses Element festzulegen.
GetAnimationBaseValue(DependencyProperty)	Gibt einen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetChildrenInTabFocusOrder()	Aktiviert eine UIElement-Unterklasse , um untergeordnete Elemente verfügbar zu machen, die am Tabstoppfokus teilnehmen.
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
GetVisualInternal()	Ruft das `Visual` Element ab, in das das Element aufgelöst wird.
InvalidateArrange()	Ungültiger Anordnungszustand (Layout) für ein UIElement. Nach der Ungültigheit wird das UIElement das Layout aktualisiert, das asynchron auftritt.
InvalidateMeasure()	Ungültiger Maßzustand (Layout) für ein UIElement.
Measure(Size)	Aktualisiert die DesiredSize eines UIElements. In der Regel rufen Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Layoutelemente implementieren, diese Methode aus ihren eigenen MeasureOverride-Implementierungen auf, um eine rekursive Layoutaktualisierung zu bilden.
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)	Wird aufgerufen, bevor das BringIntoViewRequested-Ereignis auftritt.
OnCreateAutomationPeer()	Wenn sie in einer abgeleiteten Klasse implementiert wird, werden klassenspezifische AutomationPeerimplementierungen für die Microsoft UI Automation Infrastruktur zurückgegeben.
OnDisconnectVisualChildren()	Überschreiben Sie diese Methode, um zu implementieren, wie sich Layout und Logik verhalten sollen, wenn Elemente aus einer klassenspezifischen Inhalts- oder untergeordneten Eigenschaft entfernt werden.
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)	Wird aufgerufen, wenn eine Tastenkombination (oder Zugriffstaste) in Ihrer App verarbeitet wird. Überschreiben Sie diese Methode, um zu behandeln, wie Ihre App reagiert, wenn eine Zugriffstaste aufgerufen wird.
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	Wird direkt aufgerufen, bevor eine Tastenkombination (oder Zugriffstaste) in Ihrer App verarbeitet wird. Wird immer aufgerufen, wenn Anwendungscode oder interne Prozesse ProcessKeyboardAccelerators aufrufen. Überschreiben Sie diese Methode, um die Standardmäßige Zugriffstastenbehandlung zu beeinflussen.
PopulatePropertyInfo(String, AnimationPropertyInfo)	Definiert eine Eigenschaft, die animiert werden kann.
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	Wenn eine abgeleitete Klasse überschrieben wird, wird eine Eigenschaft definiert, die animiert werden kann.
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt wird. (Geerbt von DependencyObject)
RegisterAsScrollPort(UIElement)	Registriert ein Element als Darstellung eines bildlauffähigen Viewports.
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen. (Geerbt von DependencyObject)
ReleasePointerCapture(Pointer)	Gibt Zeigererfassungen für die Erfassung eines bestimmten Zeigers durch dieses UIElement frei.
ReleasePointerCaptures()	Gibt alle Zeigererfassungen frei, die von diesem Element gehalten werden.
RemoveHandler(RoutedEvent, Object)	Entfernt den angegebenen Routingereignishandler aus diesem UIElement. In der Regel wurde der fragliche Handler von AddHandler hinzugefügt.
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
StartAnimation(ICompositionAnimationBase)	Beginnt die angegebene Animation für das Element.
StartBringIntoView()	Initiiert eine Anforderung an das XAML-Framework, um das Element in alle bildlauffähigen Bereiche anzuzeigen, in der es enthalten ist.
StartBringIntoView(BringIntoViewOptions)	Initiiert eine Anforderung an das XAML-Framework, um das Element mithilfe der angegebenen Optionen in die Ansicht zu bringen.
StartDragAsync(ExpPointerPoint)	`UIElement` ist eine Basisklasse für die meisten Windows Runtime UI-Objekte mit visuellem Erscheinungsbild und kann grundlegende Eingaben als Teil der Benutzeroberfläche Ihrer App verarbeiten.
StartDragAsync(PointerPoint)	Initiiert einen Drag-and-Drop-Vorgang. Wichtig Wird nicht unterstützt, wenn ein Benutzer die App im Modus mit erhöhten Rechten ausführt, als Administrator.
StopAnimation(ICompositionAnimationBase)	Beendet die angegebene Animation für das Element.
TransformToVisual(UIElement)	Gibt ein Transformationsobjekt zurück, das zum Transformieren von Koordinaten vom UIElement in das angegebene Objekt verwendet werden kann.
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	Versucht, eine Tastenkombination (oder Zugriffstaste) aufzurufen, indem die gesamte visuelle Struktur des UIElements nach der Verknüpfung durchsucht wird.
TryStartDirectManipulation(Pointer)	Setzt die direkte Manipulationsverarbeitung (systemdefiniertes Verschieben/Zoomen) für jedes übergeordnete ScrollViewer-Element fort, das das aktuelle UIElement enthält.
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject)
UpdateLayout()	Stellt sicher, dass alle Positionen untergeordneter Objekte eines UIElements für das Layout ordnungsgemäß aktualisiert werden.

Ereignisse

Name	Beschreibung
AccessKeyDisplayDismissed	Tritt auf, wenn Zugriffstasten nicht mehr angezeigt werden sollen.
AccessKeyDisplayRequested	Tritt auf, wenn der Benutzer die Anzeige von Zugriffstasten anfordert.
AccessKeyInvoked	Tritt auf, wenn ein Benutzer eine Zugriffstastenabfolge abgeschlossen hat.
BringIntoViewRequested	Tritt auf, wenn StartBringIntoView für dieses Element oder eines seiner Nachfolger aufgerufen wird.
CharacterReceived	Tritt auf, wenn ein einzelnes, zusammengesetztes Zeichen von der Eingabewarteschlange empfangen wird.
ContextCanceled	Tritt auf, wenn eine Kontexteingabegeste in eine Manipulationsgeste fortgesetzt wird, um das Element zu benachrichtigen, dass das Kontextflyout nicht geöffnet werden soll.
ContextRequested	Tritt auf, wenn der Benutzer eine Kontexteingabegeste abgeschlossen hat, z. B. mit der rechten Maustaste.
DoubleTapped	Tritt auf, wenn eine andernfalls nicht behandelte DoubleTap-Interaktion über dem Treffertestbereich dieses Elements erfolgt.
DragEnter	Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drag-Ereignis mit diesem Element als Ziel meldet.
DragLeave	Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drag-Ereignis mit diesem Element als Ursprung meldet.
DragOver	Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drag-Ereignis mit diesem Element als potenzielles Drop-Ziel meldet.
DragStarting	Tritt auf, wenn ein Ziehvorgang initiiert wird.
Drop	Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drop-Ereignis mit diesem Element als Drop-Ziel meldet.
DropCompleted	Tritt auf, wenn ein Drag-and-Drop-Vorgang mit diesem Element beendet wird, während die Quelle beendet wird.
GettingFocus	Tritt auf, bevor ein UIElement den Fokus erhält. Dieses Ereignis wird synchron ausgelöst, um sicherzustellen, dass der Fokus nicht verschoben wird, während das Ereignis bubblingt.
GotFocus	Tritt auf, wenn ein UIElement den Fokus erhält. Dieses Ereignis wird asynchron ausgelöst, sodass der Fokus erneut verschoben werden kann, bevor die Bubbling abgeschlossen ist.
Holding	Tritt auf, wenn eine andernfalls nicht behandelte Haltebereich über den Treffertestbereich dieses Elements erfolgt.
KeyDown	Tritt auf, wenn eine Tastatur gedrückt wird, während das UIElement den Fokus hat.
KeyUp	Tritt auf, wenn eine Tastaturtaste losgelassen wird, während das UIElement den Fokus hat.
LosingFocus	Tritt auf, bevor ein UIElement den Fokus verliert. Dieses Ereignis wird synchron ausgelöst, um sicherzustellen, dass der Fokus nicht verschoben wird, während das Ereignis bubblingt.
LostFocus	Tritt auf, wenn ein UIElement den Fokus verliert. Dieses Ereignis wird asynchron ausgelöst, sodass der Fokus erneut verschoben werden kann, bevor die Bubbling abgeschlossen ist.
ManipulationCompleted	Tritt auf, wenn eine Bearbeitung für das UIElement abgeschlossen ist.
ManipulationDelta	Tritt auf, wenn das Eingabegerät die Position während einer Manipulation ändert.
ManipulationInertiaStarting	Tritt auf, wenn das Eingabegerät den Kontakt mit dem UIElement -Objekt während einer Manipulation verliert und die Tia beginnt.
ManipulationStarted	Tritt auf, wenn ein Eingabegerät mit einer Manipulation des UIElements beginnt.
ManipulationStarting	Tritt auf, wenn der Bearbeitungsprozessor zum ersten Mal erstellt wird.
NoFocusCandidateFound	Tritt auf, wenn ein Benutzer versucht, den Fokus (über Tabulator- oder Richtungspfeile) zu verschieben, aber der Fokus wird nicht verschoben, da kein Fokuskandidat in richtung der Bewegung gefunden wird.
PointerCanceled	Tritt auf, wenn ein Zeiger, der Kontakt ungewöhnlich kontaktiert hat, den Kontakt verliert.
PointerCaptureLost	Tritt auf, wenn der Zeiger, der zuvor von diesem Element gehalten wurde, in ein anderes Element oder an eine andere Stelle verschoben wird.
PointerEntered	Tritt auf, wenn ein Zeiger in den Treffertestbereich dieses Elements wechselt.
PointerExited	Tritt auf, wenn ein Zeiger den Treffertestbereich dieses Elements verlässt.
PointerMoved	Tritt auf, wenn ein Zeiger bewegt wird, während der Zeiger im Treffertestbereich dieses Elements verbleibt.
PointerPressed	Tritt auf, wenn das Zeigergerät eine Drücken-Aktion innerhalb dieses Elements initiiert.
PointerReleased	Tritt auf, wenn das Zeigergerät, das zuvor eine Drücken-Aktion initiiert hat, freigegeben wird, während innerhalb dieses Elements. Beachten Sie, dass das Ende einer Presseaktion nicht garantiert ist, dass ein `PointerReleased` Ereignis ausgelöst wird. Andere Ereignisse können stattdessen ausgelöst werden. Weitere Informationen finden Sie in den Anmerkungen.
PointerWheelChanged	Tritt auf, wenn sich der Deltawert eines Zeigerrads ändert.
PreviewKeyDown	Tritt auf, wenn eine Tastatur gedrückt wird, während das UIElement den Fokus hat.
PreviewKeyUp	Tritt auf, wenn eine Tastaturtaste losgelassen wird, während das UIElement den Fokus hat.
ProcessKeyboardAccelerators	Tritt auf, wenn eine Tastenkombination (oder Zugriffstaste) gedrückt wird.
RightTapped	Tritt auf, wenn ein Eingabereiz mit der rechten Maustaste erfolgt, während sich der Zeiger über dem Element befindet.
Tapped	Tritt auf, wenn eine andernfalls nicht behandelte Tippinteraktion über dem Treffertestbereich dieses Elements erfolgt.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?