UIElement Klasse

Definition

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
Attribute
Implementiert

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 von UIElement oder FrameworkElement- ab. In der Regel verwendete Basisklassen für abgeleitete benutzerdefinierte Klassen sind die folgenden Klassen:

Die UIElement-Klasse wird als Typparameter vieler Eigenschaften und Methoden in der Windows-Runtime-API verwendet. Beispielsweise akzeptiert die Child-Eigenschaft von Border ein einzelnes UIElement, das das Element darstellt, um das Border gezeichnet wird. Sie können jedes beliebige UIElementabgeleitete Element 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 eigenschaft Children einer beliebigen Panel Klasse.

UIElement--API und -Features

UIElement erweitert DependencyObject, das ein anderes Basiselement ist, und fügt Unterstützung für verschiedene Windows-Runtime-Featurebereiche hinzu.

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, Tastaturinteraktionenund benutzerdefinierte Benutzerinteraktionen.

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

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 Design der Touchinteraktion.

Prominente API von UIElement, die Gesten und Manipulationen unterstützen:

Grundlegende Darstellung

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

Einfaches Layout

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

Routingereignisse

Die meisten Eingabeereignisse von UIElement 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 in Übersicht über Ereignisse und Routingereignisse.

Prominente API von UIElement, die Routingereignisse unterstützen: AddHandler, RemoveHandler, *Event Eigenschaften.

Andere Plattformunterstützung

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 unter Ü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 FrameworkElementabgeleitet werden, finden Sie im Abschnitt "FrameworkElement abgeleitete Klassen" des FrameworkElement- Referenzthemas.

Eigenschaften

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- verwendet, um die Gliederung des Inhalts eines UIElement-zu definieren.

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 wurde.

Dispatcher

Gibt immer null in einer Windows App SDK-App zurück. Verwenden Sie stattdessen DispatcherQueue.

(Geerbt von DependencyObject)
DispatcherQueue

Ruft den DispatcherQueue ab, dem dieses Objekt zugeordnet ist. Die DispatcherQueue stellt eine Einrichtung dar, die auf die DependencyObject im 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 Routingereignis 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 Holding Routingereignis 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 das Steuerelement QuickInfo die Tastenkombination für die zugeordnete Zugriffstaste anzeigt.

KeyboardAcceleratorPlacementModeProperty

Identifies the KeyboardAcceleratorPlacementMode dependency property.

KeyboardAcceleratorPlacementTarget

Dient zum Abrufen oder Festlegen eines Werts, der das Steuerelement QuickInfo- angibt, das 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
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 Zugriffstasten-Zugriffstasteninfo in Relation zur 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 Zugriffstasten-Zugriffstasteninfo 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 LosingFocus Routingereignis ab.

ManipulationCompletedEvent

Ruft den Bezeichner für das ManipulationCompleted Routingereignis ab.

ManipulationDeltaEvent

Ruft den Bezeichner für das ManipulationDelta Routingereignis ab.

ManipulationInertiaStartingEvent

Ruft den Bezeichner für das ManipulationInertiaStarting Routingereignis 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 ManipulationStarted Routingereignis ab.

ManipulationStartingEvent

Ruft den Bezeichner für das ManipulationStarting Routingereignis ab.

NoFocusCandidateFoundEvent

Ruft den Bezeichner für das NoFocusCandidateFound Routingereignis 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 Zeiger Werte.

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 die Anzahl der rohen (physischen) Pixel für jedes Ansichtspixel darstellt.

RenderSize

Ruft die endgültige Rendergröße eines UIElement-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 UIElementauswirken.

RenderTransformOrigin

Dient zum Abrufen oder Festlegen des Ursprungspunkts einer möglichen Rendertransformation, die von RenderTransform-deklariert wird, relativ zu den Grenzen des UIElement-.

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 ändert, wie Tabbing und TabIndex für dieses Steuerelement funktionieren.

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 Transition Stilelementen, 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 UIElement-. Eine UIElement, die nicht sichtbar ist, wird nicht gerendert und kommuniziert nicht die gewünschte Größe an das Layout.

VisibilityProperty

Identifies the Visibility dependency property.

XamlRoot

Dient zum Abrufen oder Festlegen des XamlRoot, 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

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 handledEventsToo als true an, damit 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 Bearbeitungsverarbeitung (systemdefiniertes Schwenken/Zoomen) auf einem beliebigen übergeordneten ScrollViewer übergeordneten 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)

Ermöglicht 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 ein UIElement- Unterklasse, um untergeordnete Elemente verfügbar zu machen, die teil am Tabstoppfokus teilnehmen.

GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject-zurück.

(Geerbt von DependencyObject)
GetVisualInternal()

Ruft die Visual ab, in die 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 ausgeführt wird.

InvalidateMeasure()

Ungültiger Maßzustand (Layout) für ein UIElement-.

Measure(Size)

Aktualisiert die DesiredSize- eines UIElement-. In der Regel rufen Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Layoutelemente implementieren, diese Methode aus ihrem 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 AutomationPeer Implementierungen für die Microsoft-Benutzeroberflächenautomatisierungs-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 vor einer Tastenkombination (oder Tastenkombination) aufgerufen, in Ihrer App verarbeitet wird. Wird aufgerufen, wenn Anwendungscode oder interne Prozesse ProcessKeyboardAcceleratorsaufrufen. Ü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 AddHandlerhinzugefü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 aus dem 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 Bearbeitungsverarbeitung (systemdefiniertes Verschieben/Zoomen) auf einem beliebigen übergeordneten ScrollViewer übergeordneten Element fort, das das aktuelle UIElement-enthält.

UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen RegisterPropertyChangedCallback-registriert wurde.

(Geerbt von DependencyObject)
UpdateLayout()

Stellt sicher, dass alle Positionen untergeordneter Objekte eines UIElement- für das Layout ordnungsgemäß aktualisiert werden.

Ereignisse

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 den 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 Interaktion über dem 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 des 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 verliert, während einer Manipulation und Inertia beginnt.

ManipulationStarted

Tritt auf, wenn ein Eingabegerät mit einer Manipulation des UIElement-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 Drücken Aktion 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 Tastenkombination) 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 Tippen Interaktion über den Treffertestbereich dieses Elements erfolgt.

Gilt für:

Weitere Informationen