SwapChainPanel Klasse

Definition

Stellt eine Hostingoberfläche bereit, auf der Microsoft DirectX-Swapchains Inhalte bereitstellen, die in einer XAML-Benutzeroberfläche gerendert werden können. Ein SwapChainPanel-Element ist eine wichtige Komponente für eine App, die Microsoft DirectX-Grafiken rendert und diese Visuals dann auf einer XAML-Seite darstellt.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SwapChainPanel : Grid
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class SwapChainPanel : Grid
Public Class SwapChainPanel
Inherits Grid
<SwapChainPanel .../>
Vererbung
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Ein SwapChainPanel ist eine Grid-Unterklasse , sodass Sie die Eigenschaften ColumnDefinitions und RowDefinitions verwenden können, um die Eigenschaften des Bereichs und die angefügten Eigenschaften von Grid wie Grid.Row und Grid.Column für untergeordnete Elemente zu deklarieren, um diese untergeordneten Elemente im Layout zu positionieren.

SwapChainPanel erbt die Background-Eigenschaft von Panel, aber Sie können den Hintergrund nicht auf einem SwapChainPanel festlegen. Wenn Sie versuchen, ihn festzulegen, tritt ein Fehler auf.

Die SwapChainPanel-Klasse erbt nicht von der Control-Klasse , sodass Sie sie nicht programmgesteuert zum Erfassen von Schlüsselereignissen direkt konzentrieren können. Erwägen Sie, den Fokus auf ein fokussierbares Element innerhalb des Bereichs festzulegen und das Schlüsselereignis blasen zu lassen.

Um ein klares Vektorrendering zu gewährleisten, sollten Sie auf das CompositionScaleChanged-Ereignis lauschen und die CompositionScaleX - und CompositionScaleY-Eigenschaftswerte abfragen, um die aktuelle Ui-Skalierung zu berücksichtigen, und möglicherweise erneut von DirectX aus gerendert werden. Andernfalls kann das XAML-Layout die Skalierung durchführen, und Ihre Visuals werden möglicherweise heruntergestuft.

Initialisieren eines SwapChainPanel-Elements

Codebeispiele, die SwapChainPanel verwenden, finden Sie unter XAML SwapChainPanel DirectX-Interoperabilitätsbeispiel.

Bevor ein SwapChainPanel Inhalte rendern kann, müssen Sie sie von der Microsoft DirectX-Seite initialisieren.

Wandeln Sie die SwapChainPanel-instance in IInspectable oder IUnknown um, und rufen Sie dann QueryInterface auf, um einen Verweis auf die ISwapChainPanelNative-Schnittstelle zu erhalten (dies ist die native Schnittstellenimplementierung, die die Ergänzung zu SwapChainPanel darstellt und die Interop-Brücke aktiviert). Rufen Sie dann ISwapChainPanelNative.SetSwapChain für diesen Verweis auf, um Die implementierte Swapchain dem swapChainPanel-instance zuzuordnen.

Es ist üblich, den Code zu platzieren, der die Schnittstelle abfragt und die Swapchain als Teil einer Create*Resources-Methode festlegt. Die Create*Resources-Methoden sind ein Implementierungsmuster, das in den Vorlagen/Beispielen der Microsoft DirectX Renderer-Klasse zu sehen ist. Dieses Implementierungsmuster wird auch in den SDK-Beispielen und im Code angezeigt, den Sie aus der DirectX-Projektvorlage (XAML) in Microsoft Visual Studio erhalten. Insbesondere in der DirectX-Projektvorlage (XAML) werden der QueryInterface-Aufruf und der Aufruf von ISwapChainPanelNative.SetSwapChain in der DeviceResources::CreateWindowSizeDependentResources Methodenimplementierung in DeviceResources.cpp angezeigt.

Die API, mit der Sie einer vorhandenen SwapChainPanel eine SwapChain hinzufügen können, ist keine Laufzeitklassen-API, sie ist eine Microsoft DirectX-API. Sie implementieren die Swapchaineingabe als Microsoft DirectX-Schnittstelle (IDXGISwapChain).

SwapChainPanel und SwapChainBackgroundPanel

SwapChainPanel hat weniger Einschränkungen hinsichtlich der Interaktionen und der Platzierung in der Benutzeroberfläche als SwapChainBackgroundPanel.

  • SwapChainPanel kann als Steuerelement überall in einer visuellen Struktur einer Seite verwendet werden. SwapChainBackgroundPanel kann nur das Stammelement sein.
  • Die typische XAML-UI-API, die von der Grid-Basisklasse geerbt wird, kann auf einem SwapChainPanel verwendet werden. SwapChainBackgroundPanel ermöglicht es Ihnen nicht, die meisten geerbten Grid-API festzulegen.
  • Für neue Apps sollten Sie im Allgemeinen SwapChainPanel verwenden und SwapChainBackgroundPanel als legacy-Technik für Windows 8-Apps betrachten, die nicht für Windows 8.1 aktualisiert wurden.

Swapchains

  • Swapchains müssen im Standard UI-Thread ausgeführt werden. Dies wird in der Regel erreicht, indem SetSwapChain für einen Verweis aufgerufen wird, der als XAML-Objektelement initialisiert wurde.
  • Eine einzelne Swapchain kann mehreren SwapChainPanel-Elementen zugeordnet werden. Oder Ihre App kann über mehrere Swapchains verfügen, wobei jede die Präsentation für ein separates SwapChainPanel bereitstellt.
  • Die Leistung kann jedoch beeinträchtigt werden, wenn viele Swapchains gleichzeitig aktualisiert werden. Es wird empfohlen, dass Ihre App nicht mehr als vier Swapchains verwendet.
  • Inhalte, die über die Swapchain gerendert werden, werden nicht gestreckt, wenn die Größe vom Benutzer geändert wird. Stattdessen ähnelt das Größenänderungsverhalten der Einstellung Stretch="None" für ein Image-Element .
  • Es gibt andere Techniken zum Rendern von Swapchaininhalten, die direkt in das Kernfenster der App anstatt in ein XAML-zusammengesetztes Element gehen. Siehe CreateSwapChainForCoreWindow.

Verarbeiten von Eingaben in Hintergrundthreads

Mithilfe der CreateCoreIndependentInputSource-Methode können Apps Eingaben verarbeiten und vollständig in einem oder mehreren Hintergrundthreads in einem SwapChainPanel rendern. Dies ermöglicht leistungsstarke Eingaben und Renderings unabhängig vom XAML-UI-Thread.

Konstruktoren

SwapChainPanel()

Initialisiert eine neue instance der SwapChainPanel-Klasse.

Eigenschaften

AccessKey

Ruft den Zugriffsschlüssel (mnemonic) für dieses Element ab oder legt diesen fest.

(Geerbt von UIElement)
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.

(Geerbt von UIElement)
ActualHeight

Ruft die gerenderte Höhe eines FrameworkElement ab. Siehe Hinweise.

(Geerbt von FrameworkElement)
ActualOffset

Ruft die Position dieses UIElements relativ zum übergeordneten Element ab, das während des Anordnungsdurchlaufs des Layoutprozesses berechnet wird.

(Geerbt von UIElement)
ActualSize

Ruft die Größe ab, die dieses UIElement während des Anordnens des Layoutprozesses berechnet hat.

(Geerbt von UIElement)
ActualTheme

Ruft das UI-Design ab, das derzeit vom -Element verwendet wird, das sich möglicherweise vom RequestedTheme unterscheidet.

(Geerbt von FrameworkElement)
ActualWidth

Ruft die gerenderte Breite eines FrameworkElement ab. Siehe Hinweise.

(Geerbt von FrameworkElement)
AllowDrop

Ruft einen Wert ab, der bestimmt, ob dieses UIElement ein Ablageziel für Drag-and-Drop-Vorgänge sein kann, oder legt diesen fest.

(Geerbt von UIElement)
AllowFocusOnInteraction

Ruft einen Wert ab, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer mit ihm interagiert, oder legt diesen fest.

(Geerbt von FrameworkElement)
AllowFocusWhenDisabled

Ruft ab oder legt fest, ob ein deaktiviertes Steuerelement den Fokus erhalten kann.

(Geerbt von FrameworkElement)
Background

Ruft einen Pinsel ab, der den Bereichsinhaltsbereich ausfüllt, oder legt diesen fest.

(Geerbt von Panel)
BackgroundSizing

Ruft einen Wert ab, der angibt, wie weit der Hintergrund im Verhältnis zum Rahmen dieses Elements erweitert wird, oder legt diesen fest.

(Geerbt von Grid)
BackgroundTransition

Ruft einen instance von BrushTransition ab, um Änderungen an der Background-Eigenschaft automatisch zu animieren, oder legt diesen fest.

(Geerbt von Panel)
BaseUri

Ruft einen Uniform Resource Identifier (URI) ab, der den Basis-URI (Uniform Resource Identifier) für ein XAML-erstelltes Objekt zur XAML-Ladezeit darstellt. Diese Eigenschaft ist nützlich für die URI-Auflösung (Uniform Resource Identifier) zur Laufzeit.

(Geerbt von FrameworkElement)
BorderBrush

Ruft einen Pinsel ab, der die Rahmenfüllung des Bereichs beschreibt, oder legt diesen fest.

(Geerbt von Grid)
BorderThickness

Ruft die Rahmenstärke des Bereichs ab oder legt diese fest.

(Geerbt von Grid)
CacheMode

Ruft einen Wert ab, der angibt, dass gerenderte Inhalte nach Möglichkeit als zusammengesetzte Bitmap zwischengespeichert werden sollen, oder legt diesen fest.

(Geerbt von UIElement)
CanBeScrollAnchor

Ruft einen Wert ab, der angibt, ob das UIElement ein Kandidat für die Bildlaufankerung sein kann, oder legt diesen fest.

(Geerbt von UIElement)
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.

(Geerbt von UIElement)
CenterPoint

Ruft den Mittelpunkt des Elements ab, der der Punkt ist, über den die Drehung oder Skalierung erfolgt, oder legt diesen fest. Wirkt sich auf die Renderingposition des Elements aus.

(Geerbt von UIElement)
Children

Ruft die Auflistung der untergeordneten Elemente des Bereichs ab.

(Geerbt von Panel)
ChildrenTransitions

Ruft die Auflistung von Übergangsstilelementen ab, die für untergeordnete Inhalte einer Panel-Unterklasse gelten, oder legt sie fest.

(Geerbt von Panel)
Clip

Ruft die RectangleGeometry ab, die verwendet wird, um die Gliederung des Inhalts eines UIElements zu definieren, oder legt sie fest.

(Geerbt von UIElement)
ColumnDefinitions

Ruft eine Liste der ColumnDefinition-Objekte ab, die für diese instance von Grid definiert sind.

(Geerbt von Grid)
ColumnSpacing

Ruft den einheitlichen Abstand (in Pixel) zwischen Rasterspalten ab oder legt diese fest.

(Geerbt von Grid)
CompositeMode

Ruft eine Eigenschaft ab, die alternative Kompositions- und Füllmodi für das Element im übergeordneten Layout und Fenster deklariert, oder legt diese fest. Dies ist für Elemente relevant, die an einer gemischten XAML-/Microsoft DirectX-Benutzeroberfläche beteiligt sind.

(Geerbt von UIElement)
CompositionScaleX

Ruft den x-Achsen-Skalierungsfaktor des SwapChainPanel ab.

CompositionScaleXProperty

Gibt die CompositionScaleX-Abhängigkeitseigenschaft an.

CompositionScaleY

Ruft den Skalierungsfaktor der y-Achse des SwapChainPanel ab.

CompositionScaleYProperty

Gibt die CompositionScaleY-Abhängigkeitseigenschaft an.

ContextFlyout

Ruft das flyout ab, das diesem Element zugeordnet ist, oder legt es fest.

(Geerbt von UIElement)
CornerRadius

Ruft den Radius für die Ecken des Bereichsrahmens ab oder legt den Radius fest.

(Geerbt von Grid)
DataContext

Ruft den Datenkontext für ein FrameworkElement ab oder legt diese fest. Ein Datenkontext wird häufig verwendet, wenn ein FrameworkElement die { Binding}- Markuperweiterung verwendet und an der Datenbindung teilnimmt.

(Geerbt von FrameworkElement)
DesiredSize

Ruft die Größe ab, die dieses UIElement während des Measuredurchlaufs des Layoutprozesses berechnet hat.

(Geerbt von UIElement)
Dispatcher

Ruft den CoreDispatcher ab, dem dieses Objekt zugeordnet ist. CoreDispatcher stellt eine Funktion dar, die auf das DependencyObject im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird.

(Geerbt von DependencyObject)
ExitDisplayModeOnAccessKeyInvoked

Ruft einen Wert ab, der angibt, ob die Anzeige der Zugriffsschlüssel beim Aufrufen eines Zugriffsschlüssels geschlossen wird, oder legt diesen fest.

(Geerbt von UIElement)
FlowDirection

Ruft die Richtung ab, in der Text und andere Ui-Elemente in einem übergeordneten Element, das ihr Layout steuert, fließen, oder legt diese fest. Diese Eigenschaft kann entweder auf LeftToRight oder RightToLeft festgelegt werden. Durch Festlegen von FlowDirection auf RightToLeft für ein beliebiges Element wird die Ausrichtung nach rechts, die Lesereihenfolge von rechts nach links und das Layout des Steuerelements festgelegt, um von rechts nach links zu fließen.

(Geerbt von FrameworkElement)
FocusVisualMargin

Ruft den äußeren Rand des Fokusvisuals für ein FrameworkElement ab oder legt diese fest.

(Geerbt von FrameworkElement)
FocusVisualPrimaryBrush

Ruft den Pinsel ab, der zum Zeichnen des äußeren Rahmens eines Visuals oder Reveal eines HighVisibility Fokusvisuals für ein FrameworkElement verwendet wird, oder legt diesen fest.

(Geerbt von FrameworkElement)
FocusVisualPrimaryThickness

Ruft die Stärke des äußeren Rahmens eines Visuals oder Reveal eines HighVisibility Fokusvisuals für ein FrameworkElement ab oder legt diese fest.

(Geerbt von FrameworkElement)
FocusVisualSecondaryBrush

Ruft den Pinsel ab, der zum Zeichnen des inneren Rahmens eines Visuals oder Reveal eines HighVisibility Fokusvisuals für ein FrameworkElement verwendet wird, oder legt diesen fest.

(Geerbt von FrameworkElement)
FocusVisualSecondaryThickness

Ruft die Stärke des inneren Rahmens eines HighVisibility Oder Reveal Fokusvisuals für ein FrameworkElement ab oder legt diese fest.

(Geerbt von FrameworkElement)
Height

Ruft die vorgeschlagene Höhe eines FrameworkElements ab oder legt diese fest.

(Geerbt von FrameworkElement)
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.

(Geerbt von UIElement)
HorizontalAlignment

Ruft die horizontalen Ausrichtungseigenschaften ab, die auf ein FrameworkElement angewendet werden, wenn es in einem übergeordneten Layout(z. B. einem Bereichs- oder Elementsteuerelement) zusammengesetzt ist, oder legt diese fest.

(Geerbt von FrameworkElement)
IsAccessKeyScope

Ruft einen Wert ab, der angibt, ob ein Element seinen eigenen Zugriffsschlüsselbereich definiert, oder legt diesen fest.

(Geerbt von UIElement)
IsDoubleTapEnabled

Ruft einen Wert ab, der bestimmt, ob das DoubleTapped-Ereignis von diesem Element stammen kann, oder legt diesen fest.

(Geerbt von UIElement)
IsHitTestVisible

Ruft ab oder legt fest, ob der geschlossene Bereich dieses UIElements true-Werte für Treffertests zurückgeben kann.

(Geerbt von UIElement)
IsHoldingEnabled

Ruft einen Wert ab, der bestimmt, ob das Holding-Ereignis von diesem Element stammen kann, oder legt diesen fest.

(Geerbt von UIElement)
IsItemsHost

Ruft einen Wert ab, der angibt, ob es sich bei diesem Bereich um einen Container für Benutzeroberflächenelemente handelt, die von einem ItemsControl-Steuerelement generiert werden.

(Geerbt von Panel)
IsLoaded

Ruft einen Wert ab, der angibt, ob das Element der Elementstruktur hinzugefügt wurde und für die Interaktion bereit ist.

(Geerbt von FrameworkElement)
IsRightTapEnabled

Ruft einen Wert ab, der bestimmt, ob das RightTapped-Ereignis von diesem Element stammen kann, oder legt diesen fest.

(Geerbt von UIElement)
IsTapEnabled

Ruft einen Wert ab, der bestimmt, ob das Tapped-Ereignis von diesem Element stammen kann, oder legt diesen fest.

(Geerbt von UIElement)
KeyboardAcceleratorPlacementMode

Ruft einen Wert ab, der angibt, ob die Steuerelement-QuickInfo die Tastenkombination für die zugeordnete Tastaturbeschleunigung anzeigt, oder legt diesen fest.

(Geerbt von UIElement)
KeyboardAcceleratorPlacementTarget

Ruft einen Wert ab, der die Steuerelement-QuickInfo angibt, die die Kombination der Tastenkombination angibt, oder legt diesen fest.

(Geerbt von UIElement)
KeyboardAccelerators

Ruft die Sammlung von Tastenkombinationen ab, die eine Aktion über die Tastatur aufrufen.

Beschleuniger werden in der Regel Schaltflächen oder Menüelementen zugewiesen.

Beispiel für ein Menü mit Tastaturbeschleunigungen für verschiedene Menüelemente
Beispiel für ein Menü mit Tastaturbeschleunigungen für verschiedene Menüelemente

(Geerbt von UIElement)
KeyTipHorizontalOffset

Ruft einen Wert ab, der angibt, wie weit links oder rechts der Schlüsseltipp in Relation zum UIElement platziert wird, oder legt diesen fest.

(Geerbt von UIElement)
KeyTipPlacementMode

Ruft einen Wert ab, der angibt, wo der Schlüsseltipp für den Zugriffsschlüssel in Relation zur Begrenzung des UIElements platziert wird, oder legt diesen fest.

(Geerbt von UIElement)
KeyTipTarget

Ruft einen Wert ab, der das Element angibt, das von der Zugriffstaste Key Tip bestimmt wird, oder legt diesen fest.

(Geerbt von UIElement)
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.

(Geerbt von UIElement)
Language

Ruft Lokalisierungs-/Globalisierungsspracheninformationen ab, die für ein FrameworkElement und auch für alle untergeordneten Elemente des aktuellen FrameworkElements in der Objektdarstellung und in der Benutzeroberfläche gelten, oder legt diese fest.

(Geerbt von FrameworkElement)
Lights

Ruft die Auflistung der XamlLight-Objekte ab, die diesem Element angefügt sind.

(Geerbt von UIElement)
ManipulationMode

Ruft den ManipulationModes-Wert ab, der für das UIElement-Verhalten und die Interaktion mit Gesten verwendet wird, oder legt diese fest. Durch Festlegen dieses Werts können Die Bearbeitungsereignisse dieses Elements in App-Code verarbeitet werden.

(Geerbt von UIElement)
Margin

Ruft den äußeren Rand eines FrameworkElements ab oder legt diese fest.

(Geerbt von FrameworkElement)
MaxHeight

Ruft die maximale Höheneinschränkung eines FrameworkElement ab oder legt diese fest.

(Geerbt von FrameworkElement)
MaxWidth

Ruft die maximale Breiteseinschränkung eines FrameworkElements ab oder legt diese fest.

(Geerbt von FrameworkElement)
MinHeight

Ruft die Mindesthöheneinschränkung eines FrameworkElement ab oder legt diese fest.

(Geerbt von FrameworkElement)
MinWidth

Ruft die Mindestbreiteneinschränkung eines FrameworkElements ab oder legt diese fest.

(Geerbt von FrameworkElement)
Name

Ruft den identifizierenden Namen des Objekts ab oder legt diesen fest. Wenn ein XAML-Prozessor die Objektstruktur aus XAML-Markup erstellt, kann Laufzeitcode mit diesem Namen auf das XAML-deklarierte Objekt verweisen.

(Geerbt von FrameworkElement)
Opacity

Ruft den Grad der Deckkraft des Objekts ab oder legt diese fest.

(Geerbt von UIElement)
OpacityTransition

Ruft die ScalarTransition ab, die Änderungen an der Opacity-Eigenschaft animiert, oder legt sie fest.

(Geerbt von UIElement)
Padding

Ruft den Abstand zwischen dem Rahmen und dem untergeordneten Objekt ab oder legt diese fest.

(Geerbt von Grid)
Parent

Ruft das übergeordnete Objekt dieses FrameworkElements in der Objektstruktur ab.

(Geerbt von FrameworkElement)
PointerCaptures

Ruft den Satz aller erfassten Zeiger ab, die als Zeigerwerte dargestellt werden.

(Geerbt von UIElement)
Projection

Ruft die perspektivische Projektion (3D-Effekt) ab, die beim Rendern dieses Elements angewendet werden soll, oder legt diese fest.

(Geerbt von UIElement)
RenderSize

Ruft die endgültige Rendergröße eines UIElements ab. Die Verwendung wird nicht empfohlen. Weitere Informationen finden Sie unter Hinweise.

(Geerbt von UIElement)
RenderTransform

Ruft Transformationsinformationen ab, die sich auf die Renderingposition eines UIElements auswirken, oder legt diese fest.

(Geerbt von UIElement)
RenderTransformOrigin

Ruft den Ursprungspunkt einer möglichen Rendertransformation ab, die von RenderTransform deklariert wurde, relativ zu den Begrenzungen des UIElements, oder legt diesen fest.

(Geerbt von UIElement)
RequestedTheme

Ruft das UI-Design ab, das vom UIElement (und seinen untergeordneten Elementen) für die Ressourcenermittlung verwendet wird, oder legt es fest. Das UI-Design, das Sie mit RequestedTheme angeben, kann das Angeforderte Thema auf App-Ebene überschreiben.

(Geerbt von FrameworkElement)
Resources

Ruft das lokal definierte Ressourcenwörterbuch ab. In XAML können Sie Ressourcenelemente als untergeordnete Objektelemente eines frameworkElement.Resources Eigenschaftselements über die implizite XAML-Auflistungssyntax einrichten.

(Geerbt von FrameworkElement)
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.

(Geerbt von UIElement)
RotationAxis

Ruft die Achse ab, um die das Element gedreht werden soll, oder legt diese fest.

(Geerbt von UIElement)
RotationTransition

Ruft die ScalarTransition ab, die Änderungen an der Rotation-Eigenschaft animiert, oder legt diese fest.

(Geerbt von UIElement)
RowDefinitions

Ruft eine Liste der RowDefinition-Objekte ab, die für diese instance von Grid definiert sind.

(Geerbt von Grid)
RowSpacing

Ruft den gleichmäßigen Abstand (in Pixel) zwischen Rasterzeilen ab oder legt diese fest.

(Geerbt von Grid)
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.

(Geerbt von UIElement)
ScaleTransition

Ruft den Vector3Transition ab, der Änderungen an der Scale-Eigenschaft animiert, oder legt diesen fest.

(Geerbt von UIElement)
Shadow

Ruft den Schatteneffekt ab, der vom -Element umgewandelt wird, oder legt diese fest.

(Geerbt von UIElement)
Style

Ruft einen instance Style ab, der während des Layouts und Renderings auf dieses Objekt angewendet wird, oder legt diesen fest.

(Geerbt von FrameworkElement)
TabFocusNavigation

Ruft einen Wert ab, der die Funktionsweise von Tabbing und TabIndex für dieses Steuerelement ändert, oder legt diesen fest.

(Geerbt von UIElement)
Tag

Ruft einen beliebigen Objektwert ab, der zum Speichern benutzerdefinierter Informationen zu diesem Objekt verwendet werden kann, oder legt diesen fest.

(Geerbt von FrameworkElement)
Transform3D

Ruft den 3D-Transformationseffekt ab, der beim Rendern dieses Elements angewendet werden soll, oder legt diesen fest.

(Geerbt von UIElement)
TransformMatrix

Ruft die Transformationsmatrix ab, die auf das -Element angewendet werden soll, oder legt diese fest.

(Geerbt von UIElement)
Transitions

Ruft die Auflistung von Transition-Stilelementen ab, die für ein UIElement gelten, oder legt diese fest.

(Geerbt von UIElement)
Translation

Ruft die x-, y- und z-Renderingposition des Elements ab oder legt diese fest.

(Geerbt von UIElement)
TranslationTransition

Ruft den Vector3Transition ab, der Änderungen an der Translation-Eigenschaft animiert, oder legt diesen fest.

(Geerbt von UIElement)
Triggers

Ruft die Auflistung von Triggern für Animationen ab, die für ein FrameworkElement definiert sind. Nicht häufig verwendet. Siehe Hinweise.

(Geerbt von FrameworkElement)
UIContext

Ruft den Kontextbezeichner für das -Element ab.

(Geerbt von UIElement)
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.

(Geerbt von UIElement)
VerticalAlignment

Ruft die vertikalen Ausrichtungseigenschaften ab, die auf ein FrameworkElement angewendet werden, wenn es in einem übergeordneten Objekt wie einem Bereichs- oder Elementsteuerelement zusammengesetzt ist, oder legt diese fest.

(Geerbt von FrameworkElement)
Visibility

Ruft die Sichtbarkeit eines UIElements ab oder legt diese fest. Ein UIElement , das nicht sichtbar ist, wird nicht gerendert und kommuniziert nicht die gewünschte Größe an das Layout.

(Geerbt von UIElement)
Width

Ruft die Breite eines FrameworkElements ab oder legt diese fest.

(Geerbt von FrameworkElement)
XamlRoot

Ruft die ab, in der XamlRoot dieses Element angezeigt wird, oder legt diesen fest.

(Geerbt von UIElement)
XYFocusDownNavigationStrategy

Ruft einen Wert ab, der die Strategie angibt, mit der das Zielelement einer Navigation nach unten bestimmt wird, oder legt diesen fest.

(Geerbt von UIElement)
XYFocusKeyboardNavigation

Ruft einen Wert ab, der die Navigation mithilfe der Richtungspfeile der Tastatur aktiviert oder deaktiviert, oder legt diesen fest.

(Geerbt von UIElement)
XYFocusLeftNavigationStrategy

Ruft einen Wert ab, der die Strategie angibt, die zum Bestimmen des Zielelements einer linken Navigation verwendet wird, oder legt diesen fest.

(Geerbt von UIElement)
XYFocusRightNavigationStrategy

Ruft einen Wert ab, der die Strategie angibt, mit der das Zielelement einer rechten Navigation bestimmt wird, oder legt diesen fest.

(Geerbt von UIElement)
XYFocusUpNavigationStrategy

Ruft einen Wert ab, der die Strategie angibt, mit der das Zielelement einer navigation nach oben bestimmt wird, oder legt diesen fest.

(Geerbt von UIElement)

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 handledEventsToo als true an, damit der bereitgestellte Handler aufgerufen wird, auch wenn das Ereignis an anderer Stelle behandelt wird.

(Geerbt von UIElement)
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 ein rekursives Layoutupdate zu bilden.

(Geerbt von UIElement)
ArrangeOverride(Size)

Stellt das Verhalten für den Layoutdurchlauf "Anordnen" bereit. Klassen können diese Methode überschreiben, um ihr eigenes Passverhalten "Arrange" zu definieren.

(Geerbt von FrameworkElement)
CancelDirectManipulations()

Bricht die laufende verarbeitung der direkten Bearbeitung (systemdefiniertes Schwenken/Zoomen) für alle übergeordneten ScrollViewer-Elemente ab, die das aktuelle UIElement enthalten.

(Geerbt von UIElement)
CapturePointer(Pointer)

Legt die Zeigererfassung auf ein UIElement fest. Nach der Erfassung löst nur das Element mit der Erfassung zeigerbezogene Ereignisse aus.

(Geerbt von UIElement)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Abhängigkeitseigenschaft.

(Geerbt von DependencyObject)
CreateCoreIndependentInputSource(CoreInputDeviceTypes)

Erstellt ein Kerneingabeobjekt, das die Eingabetypen verarbeitet, wie durch den deviceTypes-Parameter angegeben. Dieses Kerneingabeobjekt kann Eingabeereignisse in einem Hintergrundthread verarbeiten.

FindName(String)

Ruft ein Objekt ab, das über den angegebenen Bezeichnernamen verfügt.

(Geerbt von FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

Ermöglicht einer UIElement-Unterklasse das Verfügbarmachen untergeordneter Elemente, die beim Auflösen der Touch-Targeting helfen.

(Geerbt von UIElement)
GetAnimationBaseValue(DependencyProperty)

Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft festgelegt wurde, was in Fällen gilt, in denen eine Animation nicht aktiv ist.

(Geerbt von DependencyObject)
GetBindingExpression(DependencyProperty)

Gibt den BindingExpression zurück, der die Bindung für die angegebene Eigenschaft darstellt.

(Geerbt von FrameworkElement)
GetChildrenInTabFocusOrder()

Ermöglicht einer UIElement-Unterklasse das Verfügbarmachen untergeordneter Elemente, die am Tab-Fokus beteiligt sind.

(Geerbt von UIElement)
GetValue(DependencyProperty)

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

(Geerbt von DependencyObject)
GoToElementStateCore(String, Boolean)

Wenn sie in einer abgeleiteten Klasse implementiert ist, wird die Erstellung einer visuellen Struktur pro Zustand für eine Steuerelementvorlage im Code aktiviert, anstatt XAML für alle Zustände beim Start des Steuerelements zu laden.

(Geerbt von FrameworkElement)
InvalidateArrange()

Ungültig wird der Anordnungszustand (Layout) für ein UIElement. Nach der Ungültigkeit wird das UIElement-Layout aktualisiert, was asynchron erfolgt.

(Geerbt von UIElement)
InvalidateMeasure()

Ungültigiert den Messzustand (Layout) für ein UIElement.

(Geerbt von UIElement)
InvalidateViewport()

Ungültigisiert den Viewportstatus für ein UIElement , das zum Berechnen des effektiven Viewports verwendet wird.

(Geerbt von FrameworkElement)
Measure(Size)

Updates die DesiredSize-Größe 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 ein rekursives Layoutupdate zu bilden.

(Geerbt von UIElement)
MeasureOverride(Size)

Stellt das Verhalten für den Durchlauf "Measure" des Layoutzyklus bereit. Klassen können diese Methode überschreiben, um ihr eigenes Measure-Passverhalten zu definieren.

(Geerbt von FrameworkElement)
OnApplyTemplate()

Wird immer dann aufgerufen, wenn Anwendungscode oder interne Prozesse (z. B. ein neuer Erstellter Layoutdurchlauf) ApplyTemplate aufrufen. Einfach ausgedrückt bedeutet dies, dass die Methode aufgerufen wird, bevor ein UI-Element in Ihrer App angezeigt wird. Überschreiben Sie diese Methode, um die Standardlogik nach der Vorlage einer Klasse zu beeinflussen.

(Geerbt von FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Wird aufgerufen, bevor das Ereignis BringIntoViewRequested auftritt.

(Geerbt von UIElement)
OnCreateAutomationPeer()

Gibt bei Implementierung in einer abgeleiteten Klasse klassenspezifische AutomationPeer-Implementierungen für die Microsoft UI Automation-Infrastruktur zurück.

(Geerbt von UIElement)
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.

(Geerbt von UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

Wird aufgerufen, wenn eine Tastenkombination (oder Einschleunigung) in Ihrer App verarbeitet wird. Überschreiben Sie diese Methode, um zu verarbeiten, wie Ihre App reagiert, wenn eine Tastaturbeschleunigung aufgerufen wird.

(Geerbt von UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Wird aufgerufen, bevor eine Tastenkombination (oder ein Tastenkombinationsbeschleuniger) in Ihrer App verarbeitet wird. Wird immer aufgerufen, wenn Anwendungscode oder interne Prozesse ProcessKeyboardAccelerators aufrufen. Überschreiben Sie diese Methode, um die Standardbeschleunigung zu beeinflussen.

(Geerbt von UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Definiert eine Eigenschaft, die animiert werden kann.

(Geerbt von UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

Definiert beim Überschreiben in einer abgeleiteten Klasse eine Eigenschaft, die animiert werden kann.

(Geerbt von UIElement)
ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist.

(Geerbt von DependencyObject)
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.

(Geerbt von UIElement)
ReleasePointerCaptures()

Gibt alle Zeigererfassungen frei, die von diesem Element gespeichert werden.

(Geerbt von UIElement)
RemoveHandler(RoutedEvent, Object)

Entfernt den angegebenen Routingereignishandler aus diesem UIElement. In der Regel wurde der betreffende Handler von AddHandler hinzugefügt.

(Geerbt von UIElement)
SetBinding(DependencyProperty, BindingBase)

Fügt mithilfe des bereitgestellten Bindungsobjekts eine Bindung an ein FrameworkElement an.

(Geerbt von FrameworkElement)
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.

(Geerbt von UIElement)
StartBringIntoView()

Initiiert eine Anforderung an das XAML-Framework, um das Element in allen scrollbaren Regionen anzuzeigen, in der es enthalten ist.

(Geerbt von UIElement)
StartBringIntoView(BringIntoViewOptions)

Initiiert eine Anforderung an das XAML-Framework, um das Element mithilfe der angegebenen Optionen anzuzeigen.

(Geerbt von UIElement)
StartDragAsync(PointerPoint)

Leitet einen Drag & Drop-Vorgang ein.

(Geerbt von UIElement)
StopAnimation(ICompositionAnimationBase)

Beendet die angegebene Animation für das Element.

(Geerbt von UIElement)
TransformToVisual(UIElement)

Gibt ein Transformationsobjekt zurück, das verwendet werden kann, um Koordinaten vom UIElement in das angegebene Objekt zu transformieren.

(Geerbt von UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Versucht, eine Tastenkombination (oder zugriffstaste) aufzurufen, indem die gesamte visuelle Struktur des UIElements nach der Verknüpfung durchsucht wird.

(Geerbt von UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Bricht eine Änderungsbenachrichtigung ab, die zuvor registriert wurde, indem RegisterPropertyChangedCallback aufgerufen wurde.

(Geerbt von DependencyObject)
UpdateLayout()

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

(Geerbt von UIElement)

Ereignisse

AccessKeyDisplayDismissed

Tritt auf, wenn Zugriffsschlüssel nicht mehr angezeigt werden sollen.

(Geerbt von UIElement)
AccessKeyDisplayRequested

Tritt auf, wenn der Benutzer die Anzeige von Zugriffsschlüsseln anfordert.

(Geerbt von UIElement)
AccessKeyInvoked

Tritt auf, wenn ein Benutzer eine Zugriffsschlüsselsequenz abschließt.

(Geerbt von UIElement)
ActualThemeChanged

Tritt auf, wenn sich der Wert der ActualTheme-Eigenschaft geändert hat.

(Geerbt von FrameworkElement)
BringIntoViewRequested

Tritt auf, wenn StartBringIntoView für dieses Element oder eines seiner abhängigen Elemente aufgerufen wird.

(Geerbt von UIElement)
CharacterReceived

Tritt auf, wenn ein einzelnes, zusammengesetztes Zeichen von der Eingabewarteschlange empfangen wird.

(Geerbt von UIElement)
CompositionScaleChanged

Tritt auf, wenn sich der Kompositionsskalierungsfaktor des SwapChainPanels geändert hat.

ContextCanceled

Tritt auf, wenn eine Kontexteingabegeste zu einer Bearbeitungsgeste fortgesetzt wird, um das Element zu benachrichtigen, dass das Kontextflyout nicht geöffnet werden soll.

(Geerbt von UIElement)
ContextRequested

Tritt auf, wenn der Benutzer eine Kontexteingabegeste abgeschlossen hat, z. B. einen Rechtsklick.

(Geerbt von UIElement)
DataContextChanged

Tritt auf, wenn sich der Wert der FrameworkElement.DataContext-Eigenschaft ändert.

(Geerbt von FrameworkElement)
DoubleTapped

Tritt auf, wenn eine ansonsten nicht behandelte DoubleTap-Interaktion über dem Treffertestbereich dieses Elements auftritt.

(Geerbt von UIElement)
DragEnter

Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ziehereignis mit diesem Element als Ziel meldet.

(Geerbt von UIElement)
DragLeave

Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ziehereignis mit diesem Element als Ursprung meldet.

(Geerbt von UIElement)
DragOver

Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drag-Ereignis mit diesem Element als potenzielles Drop-Ziel meldet.

(Geerbt von UIElement)
DragStarting

Tritt auf, wenn ein Ziehvorgang initiiert wird.

(Geerbt von UIElement)
Drop

Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ablageereignis meldet, das dieses Element als Ablageziel aufweist.

(Geerbt von UIElement)
DropCompleted

Tritt auf, wenn ein Drag-and-Drop-Vorgang mit diesem Element als Quelle beendet wird.

(Geerbt von UIElement)
EffectiveViewportChanged

Tritt auf, wenn sich der effektive Viewport des FrameworkElements ändert.

(Geerbt von FrameworkElement)
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.

(Geerbt von UIElement)
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.

(Geerbt von UIElement)
Holding

Tritt auf, wenn eine andernfalls unbehandelte Halteinteraktion über dem Treffertestbereich dieses Elements auftritt.

(Geerbt von UIElement)
KeyDown

Tritt auf, wenn eine Tastaturtaste gedrückt wird, während das UIElement den Fokus hat.

(Geerbt von UIElement)
KeyUp

Tritt auf, wenn eine Tastaturtaste freigegeben wird, während das UIElement den Fokus hat.

(Geerbt von UIElement)
LayoutUpdated

Tritt auf, wenn sich das Layout der visuellen Struktur ändert, weil layoutrelevante Eigenschaften den Wert ändern oder eine andere Aktion, die das Layout aktualisiert.

(Geerbt von FrameworkElement)
Loaded

Tritt auf, wenn ein FrameworkElement erstellt und der Objektstruktur hinzugefügt wurde und für die Interaktion bereit ist.

(Geerbt von FrameworkElement)
Loading

Tritt auf, wenn ein FrameworkElement zu laden beginnt.

(Geerbt von FrameworkElement)
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.

(Geerbt von UIElement)
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.

(Geerbt von UIElement)
ManipulationCompleted

Tritt auf, wenn eine Bearbeitung am UIElement abgeschlossen ist.

(Geerbt von UIElement)
ManipulationDelta

Tritt ein, wenn sich die Position des Eingabegeräts während einer Bearbeitung ändert.

(Geerbt von UIElement)
ManipulationInertiaStarting

Tritt auf, wenn das Eingabegerät während einer Bearbeitung Kontakt mit dem UIElement-Objekt verliert und die Trägheit beginnt.

(Geerbt von UIElement)
ManipulationStarted

Tritt auf, wenn ein Eingabegerät eine Bearbeitung am UIElement beginnt.

(Geerbt von UIElement)
ManipulationStarting

Tritt bei der ersten Erstellung des Manipulationsprozessors auf.

(Geerbt von UIElement)
NoFocusCandidateFound

Tritt auf, wenn ein Benutzer versucht, den Fokus zu verschieben (über Registerkarten- oder Richtungspfeile), aber der Fokus wird nicht verschoben, da kein Fokuskandidat in Bewegungsrichtung gefunden wird.

(Geerbt von UIElement)
PointerCanceled

Tritt auf, wenn ein Zeiger, der den Kontakt hergestellt hat, den Kontakt anormal verliert.

(Geerbt von UIElement)
PointerCaptureLost

Tritt auf, wenn die Zeigererfassung, die zuvor von diesem Element gehalten wurde, zu einem anderen Element oder an eine andere Stelle verschoben wird.

(Geerbt von UIElement)
PointerEntered

Tritt auf, wenn ein Zeiger in den Treffertestbereich dieses Elements eintritt.

(Geerbt von UIElement)
PointerExited

Tritt auf, wenn ein Zeiger den Treffertestbereich dieses Elements verlässt.

(Geerbt von UIElement)
PointerMoved

Tritt auf, wenn ein Zeiger bewegt wird, während der Zeiger innerhalb des Treffertestbereichs dieses Elements verbleibt.

(Geerbt von UIElement)
PointerPressed

Tritt auf, wenn das Zeigergerät eine Press-Aktion innerhalb dieses Elements initiiert.

(Geerbt von UIElement)
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 PointerReleased-Ereignis auslöst. Andere Ereignisse können stattdessen ausgelöst werden. Weitere Informationen finden Sie unter Hinweise.

(Geerbt von UIElement)
PointerWheelChanged

Tritt auf, wenn sich der Deltawert eines Zeigers ändert.

(Geerbt von UIElement)
PreviewKeyDown

Tritt auf, wenn eine Tastaturtaste gedrückt wird, während das UIElement den Fokus hat.

(Geerbt von UIElement)
PreviewKeyUp

Tritt auf, wenn eine Tastaturtaste losgelassen wird, während das UIElement den Fokus hat.

(Geerbt von UIElement)
ProcessKeyboardAccelerators

Tritt auf, wenn eine Tastenkombination (oder Einschleunigung) gedrückt wird.

(Geerbt von UIElement)
RightTapped

Tritt auf, wenn ein Eingabereiz mit der rechten Maustaste erfolgt, während sich der Zeiger über dem Element befindet.

(Geerbt von UIElement)
SizeChanged

Tritt auf, wenn entweder die ActualHeight - oder die ActualWidth-Eigenschaft den Wert für ein FrameworkElement ändert.

(Geerbt von FrameworkElement)
Tapped

Tritt auf, wenn eine ansonsten nicht behandelte Tap-Interaktion über den Treffertestbereich dieses Elements erfolgt.

(Geerbt von UIElement)
Unloaded

Tritt auf, wenn dieses Objekt nicht mehr mit der Standard Objektstruktur verbunden ist.

(Geerbt von FrameworkElement)

Gilt für:

Weitere Informationen