UIElement Klasse
Definition
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.
UIElement
ist eine Basisklasse für die meisten Windows-Runtime UI-Objekte, die eine visuelle Darstellung aufweisen und grundlegende Eingaben als Teil der Benutzeroberfläche Ihrer App verarbeiten können.
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
- 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 definieren, UIElement
werden von Hunderten anderer Windows-Runtime-Klassen geerbt.
Definiert zwar die Ereignisse für die Fokusberichterstattung (GotFocus, LostFocus), UIElement
definiert jedoch UIElement
keine API zum programmgesteuerten Festlegen des Fokus. Diese Funktion wird von der Control-Klasse definiert.
UIElement
macht keinen öffentlichen Konstruktor verfügbar. In der Regel leiten Sie Klassen nicht direkt von oder FrameworkElement abUIElement
. In der Regel werden die folgenden Klassen für abgeleitete benutzerdefinierte Klassen verwendet:
- Bestimmte Steuerelemente, die nicht versiegelt sind (z. B. TextBox)
- Steuerelementbasisklassen (Control, ContentControl, UserControl)
- Navigationselemente (Page, Frame)
- Panelklassen (die Basisklasse Panel oder bestimmte nicht versiegelte Implementierungen wie Grid)
Die UIElement
-Klasse wird als Typparameter vieler Eigenschaften und Methoden in der Windows-Runtime-API verwendet. Beispielsweise nimmt die Child-Eigenschaft von Border eine einzelne UIElement
an, die das Element darstellt, um das border herum gezeichnet wird. Sie können ein beliebiges UIElement
abgeleitetes Element für eine solche Eigenschaft bereitstellen, einschließlich benutzerdefinierter Steuerelemente, die Sie definieren.
Die UIElementCollection-Klasse stellt eine stark typisierte 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, das ein weiteres 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 ist in der UIElement
-Klasse definiert. Dies schließt die Ereignisse für Tastatur-, Maus-, Touch-, Drag-Drop- und Fokusinteraktionen ein. Weitere Informationen finden Sie unter Behandeln von Zeigereingaben, Tastaturinteraktionen und benutzerdefinierte Benutzerinteraktionen.
Prominente API von UIElement
, die Eingaben und Benutzerinteraktionen unterstützen:
- Zeigerereignisse:PointerPressed, PointerReleased, PointerMoved, PointerEntered, PointerExited
- Schlüsselbehandlungsereignisse:KeyDown, KeyUp
- Focus:GotFocus, LostFocus
- Zeigererfassung:CapturePointer, PointerCanceled, PointerCaptureLost, ReleasePointerCapture, PointerCaptures
- Drag-drop:DragOver, Drop, DragEnter, DragLeave, AllowDrop
- Eigenschaften, die beeinflussen, wie grundlegende Eingaben verarbeitet werden:IsHitTestVisible, AllowDrop
Gesten und Bearbeitungen
Gesten und Manipulationen sind auch eine Möglichkeit, Eingaben und Benutzerinteraktionen zu verarbeiten. Die API ist hier separat aufgeführt, da diese Ereignisse darstellen, wie das System mit Eingabeaktionen auf Geräteebene interagiert und sie als Benutzerinteraktion interpretiert. Manipulationen sind eine Möglichkeit, dynamische Multitouch-Interaktionen wie z. B. Einklemmen und Dehnen zu verarbeiten. Zusammen stellen die Gesten und Manipulationen die Touchmuster für die Touchinteraktion mit der UWP-App bereit. Weitere Informationen finden Sie unter Benutzerdefinierte Benutzerinteraktionen und Design der Touchinteraktion.
Prominente API, UIElement
die Gesten und Manipulationen unterstützt:
- Gestenereignisse:DoubleTapped, Holding, RightTapped, Tapped
- Manipulationsereignisse:ManipulationCompleted, ManipulationDelta, ManipulationInertiaStarting, ManipulationStarted, ManipulationStarting
- Eigenschaften, die die Verarbeitung von Gesten und Manipulationen beeinflussen:IsHoldingEnabled und andere Is*Enabled, ManipulationMode
Grundlegende Darstellung
Die Eigenschaften Sichtbarkeit und Deckkraft werden häufig verwendet, um die Darstellung eines Elements auf Ihrer Benutzeroberfläche anzupassen, insbesondere in Formatvorlagen, Vorlagen und visuellen Zuständen. Die Eigenschaften Clip, RenderTransform und Transitions sind jeweils nützlich, um Interaktionen und unterschiedliche Looks für Ihre Ui-Elemente zu erzeugen.
Grundlegendes Layout
Die UIElement
-Klasse bietet einen Ausgangspunkt für Layouteigenschaften 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 Ereignisbehandlungsbenachrichtigungssystem, 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 von Eingabebereichs und für das Kompositing von Steuerelementen. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.
Prominente API dieser UIElement
Unterstützung von Routingereignissen: AddHandler, RemoveHandler, *Ereigniseigenschaften .
Andere Plattformunterstützung
- OnCreateAutomationPeer ermöglicht es einer Klasse, einen benutzerdefinierten AutomationPeer für die Microsoft Benutzeroberflächenautomatisierung-Unterstützung zu verwenden.
- 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 Logik mit Geänderten Eigenschaften. Weitere Informationen zu Abhängigkeitseigenschaften und den von ihnen unterstützten Features finden Sie unter Übersicht über Abhängigkeitseigenschaften.
UIElement-abgeleitete Klassen
Die einzige Windows-Runtime Klasse, die direkt von abgeleitet UIElement
wird, ist FrameworkElement. Eine Liste der Klassen, die von FrameworkElement abgeleitet werden, finden Sie im Abschnitt "FrameworkElement abgeleitete Klassen" des FrameworkElement-Referenzthemas .
Eigenschaften
AccessKey |
Ruft den Zugriffsschlüssel (mnemonisch) für dieses Element ab oder legt diesen fest. |
AccessKeyProperty |
Identifiziert für die AccessKey-Abhängigkeitseigenschaft . |
AccessKeyScopeOwner |
Ruft ein Quellelement ab, das den Zugriffsschlüsselbereich für dieses Element bereitstellt, auch wenn es sich nicht in der visuellen Struktur des Quellelements befindet, oder legt es fest. |
AccessKeyScopeOwnerProperty |
Identifiziert für die AccessKeyScopeOwner-Abhängigkeitseigenschaft . |
ActualOffset |
Ruft die Position dieses UIElements relativ zum übergeordneten Element ab, das während des Anordnens des Layoutprozesses berechnet wird. |
ActualSize |
Ruft die Größe ab, die dieses UIElement während des Anordnens des Layoutprozesses berechnet hat. |
AllowDrop |
Ruft einen Wert ab, der bestimmt, ob dieses UIElement ein Ablageziel für Drag-and-Drop-Vorgänge sein kann, oder legt ihn fest. |
AllowDropProperty |
Identifiziert die AllowDrop-Abhängigkeitseigenschaft . |
BringIntoViewRequestedEvent |
Ruft den Bezeichner für das Routingereignis BringIntoViewRequested ab. |
CacheMode |
Ruft einen Wert ab, der angibt, dass gerenderter Inhalt nach Möglichkeit als zusammengesetzte Bitmap zwischengespeichert werden soll, oder legt diesen fest. |
CacheModeProperty |
Identifiziert die CacheMode-Abhängigkeitseigenschaft . |
CanBeScrollAnchor |
Ruft einen Wert ab, der angibt, ob das UIElement ein Kandidat für scroll anchoring sein kann, oder legt diesen fest. |
CanBeScrollAnchorProperty |
Identifiziert die CanBeScrollAnchor-Abhängigkeitseigenschaft . |
CanDrag |
Ruft einen Wert ab, der angibt, ob das Element in einem Drag-and-Drop-Vorgang als Daten gezogen werden kann, oder legt diesen fest. |
CanDragProperty |
Identifiziert die CanDrag-Abhängigkeitseigenschaft . |
CenterPoint |
Ruft den Mittelpunkt des Elements ab, d. h. der Punkt, an dem eine Drehung oder Skalierung stattfindet, oder legt diesen fest. Wirkt sich auf die Renderingposition des Elements aus. |
CharacterReceivedEvent |
Ruft den Bezeichner für das CharacterReceived-Routingereignis ab. |
Clip |
Ruft die RectangleGeometry ab, die zum Definieren der Gliederung des Inhalts eines UIElement verwendet wird, oder legt diese fest. |
ClipProperty |
Identifiziert die Clip-Abhängigkeitseigenschaft . |
CompositeMode |
Ruft eine Eigenschaft ab, die alternative Kompositions- und Mischmodi für das Element im übergeordneten Layout und Fenster deklariert, oder legt sie fest. Dies ist für Elemente relevant, die an einer gemischten XAML-/Microsoft DirectX-Benutzeroberfläche beteiligt sind. |
CompositeModeProperty |
Identifiziert die CompositeMode-Abhängigkeitseigenschaft . |
ContextFlyout |
Ruft das diesem Element zugeordnete Flyout ab oder legt es fest. |
ContextFlyoutProperty |
Identifiziert für die ContextFlyout-Abhängigkeitseigenschaft . |
ContextRequestedEvent |
Ruft den Bezeichner für das ContextRequested-Routingereignis ab. |
DesiredSize |
Ruft die Größe ab, die dieses UIElement während des Measuredurchlaufs des Layoutprozesses berechnet hat. |
Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
DispatcherQueue |
Ruft den |
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 | |
ExitDisplayModeOnAccessKeyInvoked |
Ruft einen Wert ab, der angibt, ob die Anzeige der Zugriffsschlüssel geschlossen wird, wenn ein Zugriffsschlüssel aufgerufen wird, oder legt diesen fest. |
ExitDisplayModeOnAccessKeyInvokedProperty |
Identifiziert die ExitDisplayModeOnAccessKeyInvoked-Abhängigkeitseigenschaft . |
FocusState |
Ruft einen Wert ab, der angibt, ob dieses Steuerelement den Fokus hat, und den Modus, mit dem der Fokus abgerufen wurde. |
FocusStateProperty |
Identifiziert die FocusState-Abhängigkeitseigenschaft . |
GettingFocusEvent |
Ruft den Bezeichner für das GetFocus-Routingereignis ab. |
HighContrastAdjustment |
Ruft einen Wert ab, der angibt, ob das Framework die visuellen Eigenschaften des Elements automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind, oder legt diesen fest. |
HighContrastAdjustmentProperty |
Identifiziert die HighContrastAdjustment-Abhängigkeitseigenschaft . |
HoldingEvent |
Ruft den Bezeichner für das Routingereignis Holding ab. |
IsAccessKeyScope |
Ruft einen Wert ab, der angibt, ob ein Element seinen eigenen Zugriffsschlüsselbereich definiert, oder legt diesen fest. |
IsAccessKeyScopeProperty |
Identifiziert für die IsAccessKeyScope-Abhängigkeitseigenschaft . |
IsDoubleTapEnabled |
Ruft einen Wert ab, der bestimmt, ob das DoubleTapped-Ereignis von diesem Element stammen kann, oder legt diesen fest. |
IsDoubleTapEnabledProperty |
Identifiziert die Abhängigkeitseigenschaft IsDoubleTapEnabled . |
IsHitTestVisible |
Ruft ab oder legt fest, ob der enthaltene Bereich dieses UIElements true-Werte für Treffertests zurückgeben kann. |
IsHitTestVisibleProperty |
Identifiziert die IsHitTestVisible-Abhängigkeitseigenschaft . |
IsHoldingEnabled |
Ruft einen Wert ab, der bestimmt, ob das Holding-Ereignis von diesem Element stammen kann, oder legt diesen fest. |
IsHoldingEnabledProperty |
Gibt die Abhängigkeitseigenschaft IsHoldingEnabled an. |
IsRightTapEnabled |
Ruft einen Wert ab, der bestimmt, ob das RightTapped-Ereignis von diesem Element stammen kann, oder legt diesen fest. |
IsRightTapEnabledProperty |
Identifiziert die Abhängigkeitseigenschaft IsRightTapEnabled . |
IsTabStop |
Ruft einen Wert ab, der angibt, ob ein Steuerelement in der Navigation mit der TAB-TASTE enthalten ist. |
IsTabStopProperty |
Identifiziert die UIElement.IsTabStop-Abhängigkeitseigenschaft . |
IsTapEnabled |
Ruft einen Wert ab, der bestimmt, ob das Tapped-Ereignis von diesem Element stammen kann, oder legt diesen fest. |
IsTapEnabledProperty |
Identifiziert die IsTapEnabled-Abhängigkeitseigenschaft . |
KeyboardAcceleratorPlacementMode |
Ruft einen Wert ab, der angibt, ob die QuickInfo des Steuerelements die Tastenkombination für die zugeordnete Tastenkombination anzeigt, oder legt diesen fest. |
KeyboardAcceleratorPlacementModeProperty |
Gibt die KeyboardAcceleratorPlacementMode-Abhängigkeitseigenschaft an. |
KeyboardAcceleratorPlacementTarget |
Ruft einen Wert ab, der die QuickInfo des Steuerelements angibt, mit der die Tastenkombination angezeigt wird, oder legt diesen fest. |
KeyboardAcceleratorPlacementTargetProperty |
Identifiziert die KeyboardAcceleratorPlacementTarget-Abhängigkeitseigenschaft . |
KeyboardAccelerators |
Ruft die Auflistung von Tastenkombinationen ab, die eine Aktion mithilfe der Tastatur aufrufen. Beschleuniger werden in der Regel Schaltflächen oder Menüelementen zugewiesen.
|
KeyDownEvent |
Ruft den Bezeichner für das KeyDown-Routingereignis ab. |
KeyTipHorizontalOffset |
Ruft einen Wert ab, der angibt, wie weit links oder rechts der Schlüsseltipp in Bezug auf das UIElement platziert wird, oder legt diesen fest. |
KeyTipHorizontalOffsetProperty |
Identifiziert die KeyTipHorizontalOffset-Abhängigkeitseigenschaft . |
KeyTipPlacementMode |
Ruft einen Wert ab, der angibt, wo der Schlüsseltipp für den Zugriffsschlüssel in Relation zur Grenze des UIElement platziert wird, oder legt diesen fest. |
KeyTipPlacementModeProperty |
Gibt die KeyTipPlacementMode-Abhängigkeitseigenschaft an. |
KeyTipTarget |
Ruft einen Wert ab, der das Element angibt, auf das der Schlüsseltipp für den Zugriffsschlüssel abzielt, oder legt diesen fest. |
KeyTipTargetProperty |
Identifiziert die KeyTipTarget-Abhängigkeitseigenschaft . |
KeyTipVerticalOffset |
Ruft einen Wert ab, der angibt, wie weit nach oben oder unten der Schlüsseltipp in Bezug auf das UI-Element platziert wird, oder legt diesen fest. |
KeyTipVerticalOffsetProperty |
Gibt die KeyTipVerticalOffset-Abhängigkeitseigenschaft an. |
KeyUpEvent |
Ruft den Bezeichner für das KeyUp-Routingereignis ab. |
Lights |
Ruft die Auflistung von XamlLight-Objekten ab, die an dieses Element angefügt sind. |
LightsProperty | |
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 ManipulationDelta-Routingereignis ab. |
ManipulationInertiaStartingEvent |
Ruft den Bezeichner für das Routingereignis ManipulationInertiaStarting ab. |
ManipulationMode |
Ruft den ManipulationModes-Wert ab, der für das UiElement-Verhalten und die Interaktion mit Gesten verwendet wird, oder legt den Wert fest. Das Festlegen dieses Werts ermöglicht die Behandlung der Bearbeitungsereignisse dieses Elements im App-Code. |
ManipulationModeProperty |
Identifiziert die ManipulationMode-Abhängigkeitseigenschaft . |
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 |
Ruft den Grad der Deckkraft des Objekts ab oder legt diese fest. |
OpacityProperty |
Identifiziert die IsHitTestVisible-Abhängigkeitseigenschaft . |
OpacityTransition |
Ruft die ScalarTransition ab, die Änderungen an der Opacity-Eigenschaft animiert, oder legt sie fest. |
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, die als Zeigerwerte dargestellt werden. |
PointerCapturesProperty |
Identifiziert die PointerCaptures-Abhängigkeitseigenschaft . |
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 Routingereignis PointerMoved 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 Routingereignis PointerWheelChanged ab. |
PreviewKeyDownEvent |
Ruft den Bezeichner für das Routingereignis PreviewKeyDown 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 | |
ProtectedCursor |
Ruft den Cursor ab, der angezeigt wird, wenn sich der Zeiger über diesem Element befindet, oder legt diesen fest. Der Standardwert ist NULL, was angibt, dass sich der Cursor nicht ändert. |
RasterizationScale |
Ruft einen Wert ab, der die Anzahl der unformatierten (physischen) Pixel für jedes Ansichtspixel darstellt. |
RenderSize |
Ruft die endgültige Rendergröße eines UIElements ab. Die Verwendung wird nicht empfohlen. Weitere Informationen finden Sie unter Hinweise. |
RenderTransform |
Ruft Transformationsinformationen ab, die sich auf die Renderingposition eines UIElements auswirken, oder legt diese fest. |
RenderTransformOrigin |
Ruft den Ursprungspunkt einer möglichen Rendertransformation ab, die von RenderTransform deklariert wurde, relativ zu den Begrenzungen des UIElements, oder legt diesen fest. |
RenderTransformOriginProperty |
Identifiziert die RenderTransformOrigin-Abhängigkeitseigenschaft . |
RenderTransformProperty |
Identifiziert die RenderTransform-Abhängigkeitseigenschaft . |
RightTappedEvent |
Ruft den Bezeichner für das RightTapped-Routingereignis ab. |
Rotation |
Ruft den Drehwinkel im Uhrzeigersinn in Grad ab oder legt den Drehungswinkel 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 diese fest. |
RotationTransition |
Ruft die ScalarTransition ab, die Änderungen an der Rotation-Eigenschaft animiert, oder legt diese fest. |
Scale |
Ruft die Skalierung des Elements ab oder legt diese fest. Skaliert relativ zum CenterPoint des Elements. Wirkt sich auf die Renderingposition des Elements aus. |
ScaleTransition |
Ruft den Vector3Transition ab, der Änderungen an der Scale-Eigenschaft animiert, oder legt diesen fest. |
Shadow |
Ruft den Schatteneffekt ab, der vom -Element umgewandelt wird, oder legt diese fest. |
ShadowProperty | |
TabFocusNavigation |
Ruft einen Wert ab, der die Funktionsweise von Tabbing und TabIndex für dieses Steuerelement ändert, oder legt diesen fest. |
TabFocusNavigationProperty |
Identifiziert die TabFocusNavigation-Abhängigkeitseigenschaft . |
TabIndex |
Ruft einen Wert ab, der die Reihenfolge bestimmt, in der Elemente den Fokus erhalten, wenn der Benutzer mithilfe der TAB-TASTE durch Steuerelemente navigiert, oder legt diesen fest. |
TabIndexProperty |
Identifiziert die TabIndex-Abhängigkeitseigenschaft . |
TappedEvent |
Ruft den Bezeichner für das Tapped-Routingereignis ab. |
Transform3D |
Ruft den 3D-Transformationseffekt ab, der beim Rendern dieses Elements angewendet werden soll, oder legt diesen fest. |
Transform3DProperty |
Identifiziert die Transform3D-Abhängigkeitseigenschaft . |
TransformMatrix |
Ruft die Transformationsmatrix ab, die auf das -Element angewendet werden soll, oder legt diese fest. |
Transitions |
Ruft die Auflistung von Transition-Stilelementen ab, die für ein UIElement gelten, oder legt diese fest. |
TransitionsProperty |
Identifiziert die Transitions-Abhängigkeitseigenschaft . |
Translation |
Ruft die x-, y- und z-Renderingposition des Elements ab oder legt diese fest. |
TranslationTransition |
Ruft den Vector3Transition ab, der Änderungen an der Translation-Eigenschaft animiert, oder legt diesen fest. |
UseLayoutRounding |
Ruft einen Wert ab, der bestimmt, ob das Rendern für das Objekt und seine visuelle Unterstruktur ein Rundungsverhalten verwenden soll, das das Rendering auf ganze Pixel ausgerichtet. |
UseLayoutRoundingProperty |
Identifiziert die UseLayoutRounding-Abhängigkeitseigenschaft . |
UseSystemFocusVisuals |
Ruft einen Wert ab, der angibt, ob das Steuerelement visuelle Fokusvisuals verwendet, die vom System gezeichnet wurden, oder Fokusvisuals, die in der Steuerelementvorlage definiert sind, oder legt diesen fest. |
UseSystemFocusVisualsProperty |
Identifiziert die UseSystemFocusVisuals-Abhängigkeitseigenschaft . |
Visibility |
Ruft die Sichtbarkeit eines UIElements ab oder legt diese fest. Ein |
VisibilityProperty | |
XamlRoot |
Ruft die ab, in der |
XYFocusDown |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer auf das Directional Pad (D-Pad) eines Gamecontrollers drückt, oder legt es fest. |
XYFocusDownNavigationStrategy |
Ruft einen Wert ab, der die Strategie angibt, mit der das Zielelement einer Navigation nach unten bestimmt wird, oder legt diesen fest. |
XYFocusDownNavigationStrategyProperty |
Identifiziert die XYFocusDownNavigationStrategy-Abhängigkeitseigenschaft . |
XYFocusDownProperty |
Identifiziert die XYFocusDown-Abhängigkeitseigenschaft . |
XYFocusKeyboardNavigation |
Ruft einen Wert ab, der die Navigation mithilfe der Richtungspfeile der Tastatur aktiviert oder deaktiviert, oder legt diesen fest. |
XYFocusKeyboardNavigationProperty |
Identifiziert die XYFocusKeyboardNavigation-Abhängigkeitseigenschaft . |
XYFocusLeft |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer nach links auf das Directional Pad (D-Pad) eines Gamecontrollers drückt, oder legt es fest. |
XYFocusLeftNavigationStrategy |
Ruft einen Wert ab, der die Strategie angibt, die zum Bestimmen des Zielelements einer linken Navigation verwendet wird, oder legt diesen fest. |
XYFocusLeftNavigationStrategyProperty |
Identifiziert die XYFocusLeftNavigationStrategy-Abhängigkeitseigenschaft . |
XYFocusLeftProperty |
Identifiziert die XYFocusLeft-Abhängigkeitseigenschaft . |
XYFocusRight |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer direkt auf das Directional Pad (D-Pad) eines Gamecontrollers drückt, oder legt es fest. |
XYFocusRightNavigationStrategy |
Ruft einen Wert ab, der die Strategie angibt, mit der das Zielelement einer rechten Navigation bestimmt wird, oder legt diesen fest. |
XYFocusRightNavigationStrategyProperty |
Identifiziert die XYFocusRightNavigationStrategy-Abhängigkeitseigenschaft . |
XYFocusRightProperty |
Identifiziert die XYFocusRight-Abhängigkeitseigenschaft . |
XYFocusUp |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer auf das Directional Pad (D-Pad) eines Gamecontrollers drückt, oder legt es fest. |
XYFocusUpNavigationStrategy |
Ruft einen Wert ab, der die Strategie angibt, mit der das Zielelement einer navigation nach oben bestimmt wird, oder legt diesen fest. |
XYFocusUpNavigationStrategyProperty |
Identifiziert die XYFocusUpNavigationStrategy-Abhängigkeitseigenschaft . |
XYFocusUpProperty |
Identifiziert die XYFocusUp-Abhängigkeitseigenschaft . |
Methoden
AddHandler(RoutedEvent, Object, Boolean) |
Fügt einen Routingereignishandler für ein bestimmtes Routingereignis hinzu, wobei der Handler der Handlerauflistung für das aktuelle Element hinzugefügt wird. Geben Sie |
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 verarbeitung der direkten Bearbeitung (systemdefiniertes Schwenken/Zoomen) für alle übergeordneten ScrollViewer-Elemente ab, die das aktuelle UIElement enthalten. |
CapturePointer(Pointer) |
Legt die Zeigererfassung auf ein UIElement fest. Nach der Erfassung löst nur das Element, das über capture verfügt, zeigerbezogene Ereignisse aus. |
ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject) |
FindSubElementsForTouchTargeting(Point, Rect) |
Ermöglicht es einer UIElement-Unterklasse , untergeordnete Elemente verfügbar zu machen, die beim Auflösen der Touchadressierung helfen. |
Focus(FocusState) |
Versucht, den Fokus auf dieses Element festzulegen. |
GetAnimationBaseValue(DependencyProperty) |
Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, der in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject) |
GetChildrenInTabFocusOrder() |
Ermöglicht einer UIElement-Unterklasse , untergeordnete Elemente verfügbar zu machen, die am Tabstopp-Fokus teilnehmen. |
GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject) |
GetVisualInternal() |
Ruft die |
InvalidateArrange() |
Ungültig wird der Anordnungszustand (Layout) für ein UIElement. Nach der Ungültigkeit wird das Layout des UIElement aktualisiert, was asynchron erfolgt. |
InvalidateMeasure() |
Ungültig wird der Messzustand (Layout) für ein UIElement. |
Measure(Size) |
Updates desiredSize eines UIElements aus. In der Regel rufen Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Layoutelemente implementieren, diese Methode aus ihren eigenen MeasureOverride-Implementierungen auf, um ein rekursives Layoutupdate zu bilden. |
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Wird aufgerufen, bevor das BringIntoViewRequested-Ereignis auftritt. |
OnCreateAutomationPeer() |
Gibt bei Implementierung in einer abgeleiteten Klasse klassenspezifische AutomationPeer-Implementierungen für die Microsoft Benutzeroberflächenautomatisierung-Infrastruktur zurück. |
OnDisconnectVisualChildren() |
Überschreiben Sie diese Methode, um zu implementieren, wie sich Layout und Logik verhalten sollen, wenn Elemente aus einem klassenspezifischen Inhalt oder einer untergeordneten Eigenschaft entfernt werden. |
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Wird aufgerufen, wenn eine Tastenkombination (oder Einschleunigung) in Ihrer App verarbeitet wird. Überschreiben Sie diese Methode, um zu behandeln, wie Ihre App reagiert, wenn eine Tastenkombination aufgerufen wird. |
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Wird aufgerufen, kurz bevor eine Tastenkombination (oder Einschleunigung) in Ihrer App verarbeitet wird. Wird immer aufgerufen, wenn Anwendungscode oder interne Prozesse ProcessKeyboardAccelerators aufrufen. Überschreiben Sie diese Methode, um die Standardbeschleunigung zu beeinflussen. |
PopulatePropertyInfo(String, AnimationPropertyInfo) |
Definiert eine Eigenschaft, die animiert werden kann. |
PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
Definiert beim Überschreiben in einer abgeleiteten Klasse eine Eigenschaft, die animiert werden kann. |
ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject) |
RegisterAsScrollPort(UIElement) |
Registriert ein Element als Darstellung eines scrollbaren Viewports. |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (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 gespeichert werden. |
RemoveHandler(RoutedEvent, Object) |
Entfernt den angegebenen Routingereignishandler aus diesem UIElement. In der Regel wurde der betreffende 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) |
Startet die angegebene Animation für das -Element. |
StartBringIntoView() |
Initiiert eine Anforderung an das XAML-Framework, um das Element in allen scrollbaren Regionen anzuzeigen, in der es enthalten ist. |
StartBringIntoView(BringIntoViewOptions) |
Initiiert eine Anforderung an das XAML-Framework, um das Element mithilfe der angegebenen Optionen anzuzeigen. |
StartDragAsync(ExpPointerPoint) |
|
StartDragAsync(PointerPoint) |
Leitet einen Drag & Drop-Vorgang ein. Wichtig Wird nicht unterstützt, wenn ein Benutzer die App als Administrator im Modus mit erhöhten Rechten ausführt. |
StopAnimation(ICompositionAnimationBase) |
Beendet die angegebene Animation für das Element. |
TransformToVisual(UIElement) |
Gibt ein Transformationsobjekt zurück, das verwendet werden kann, um Koordinaten vom UIElement in das angegebene Objekt zu transformieren. |
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 Schwenken/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 ordnungsgemäß für das Layout aktualisiert werden. |
Ereignisse
AccessKeyDisplayDismissed |
Tritt auf, wenn Zugriffsschlüssel nicht mehr angezeigt werden sollen. |
AccessKeyDisplayRequested |
Tritt auf, wenn der Benutzer anfordert, dass Zugriffsschlüssel angezeigt werden. |
AccessKeyInvoked |
Tritt auf, wenn ein Benutzer eine Zugriffstastensequenz abschließt. |
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 zu einer Bearbeitungsgeste 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. einen Rechtsklick. |
DoubleTapped |
Tritt auf, wenn eine ansonsten nicht behandelte DoubleTap-Interaktion über dem Treffertestbereich dieses Elements auftritt. |
DragEnter |
Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ziehereignis mit diesem Element als Ziel meldet. |
DragLeave |
Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ziehereignis 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 Ablageereignis meldet, das dieses Element als Ablageziel aufweist. |
DropCompleted |
Tritt auf, wenn ein Drag-and-Drop-Vorgang mit diesem Element als 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 sprudelt. |
GotFocus |
Tritt auf, wenn ein UIElement den Fokus erhält. Dieses Ereignis wird asynchron ausgelöst, sodass der Fokus erneut verschoben werden kann, bevor das Sprudeln abgeschlossen ist. |
Holding |
Tritt auf, wenn eine ansonsten nicht behandelte Hold-Interaktion über dem Treffertestbereich dieses Elements erfolgt. |
KeyDown |
Tritt auf, wenn eine Tastaturtaste 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 sprudelt. |
LostFocus |
Tritt auf, wenn ein UIElement den Fokus verliert. Dieses Ereignis wird asynchron ausgelöst, sodass der Fokus erneut verschoben werden kann, bevor das Sprudeln abgeschlossen ist. |
ManipulationCompleted |
Tritt auf, wenn eine Bearbeitung am UIElement abgeschlossen ist. |
ManipulationDelta |
Tritt ein, wenn sich die Position des Eingabegeräts während einer Bearbeitung ändert. |
ManipulationInertiaStarting |
Tritt auf, wenn das Eingabegerät während einer Bearbeitung Kontakt mit dem UIElement-Objekt verliert und die Trägheit beginnt. |
ManipulationStarted |
Tritt auf, wenn ein Eingabegerät mit einer Bearbeitung des UIElement beginnt. |
ManipulationStarting |
Tritt bei der ersten Erstellung des Manipulationsprozessors auf. |
NoFocusCandidateFound |
Tritt auf, wenn ein Benutzer versucht, den Fokus zu verschieben (über Tabstopp- oder Richtungspfeile), der Fokus jedoch nicht bewegt wird, weil kein Fokuskandidat in Bewegungsrichtung gefunden wird. |
PointerCanceled |
Tritt auf, wenn ein Zeiger, der den Kontakt hergestellt hat, den Kontakt anormal verliert. |
PointerCaptureLost |
Tritt auf, wenn die Zeigererfassung, die zuvor von diesem Element gehalten wurde, zu einem anderen Element oder an eine andere Stelle verschoben wird. |
PointerEntered |
Tritt auf, wenn ein Zeiger in den Treffertestbereich dieses Elements eintritt. |
PointerExited |
Tritt auf, wenn ein Zeiger den Treffertestbereich dieses Elements verlässt. |
PointerMoved |
Tritt auf, wenn ein Zeiger bewegt wird, während der Zeiger innerhalb des Treffertestbereichs dieses Elements verbleibt. |
PointerPressed |
Tritt auf, wenn das Zeigergerät eine Press-Aktion innerhalb dieses Elements initiiert. |
PointerReleased |
Tritt auf, wenn das Zeigergerät, das zuvor eine Press-Aktion initiiert hat, innerhalb dieses Elements freigegeben wird. Beachten Sie, dass das Ende einer Press-Aktion nicht garantiert ein |
PointerWheelChanged |
Tritt auf, wenn sich der Deltawert eines Zeigers ändert. |
PreviewKeyDown |
Tritt auf, wenn eine Tastaturtaste 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 Einschleunigung) 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 ansonsten nicht behandelte Tap-Interaktion über den Treffertestbereich dieses Elements erfolgt. |
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für