BitmapIcon 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.
Stellt ein Symbol dar, das eine Bitmap als Inhalt verwendet.
/// [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 BitmapIcon : IconElement[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 BitmapIcon : IconElementPublic Class BitmapIcon
Inherits IconElement<BitmapIcon .../>
- Vererbung
- Attribute
Beispiele
Tipp
Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Befehlsleiste.
Die WinUI 3-Katalog-App umfasst interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.
Dieses Beispiel zeigt einen AppBarButton mit einem BitmapIcon. Die UriSource gibt ein Bild an, das im App-Paket enthalten ist.
<AppBarButton Label="BitmapIcon" Click="AppBarButton_Click">
<AppBarButton.Icon>
<BitmapIcon UriSource="ms-appx:///Assets/globe.png"/>
</AppBarButton.Icon>
</AppBarButton>
Hinweise
Hinweis
BitmapIcon wird in der Regel verwendet, um das Symbol für einen AppBarButton bereitzustellen, und die Hinweise in diesem Abschnitt gehen von dieser Verwendung aus. Es kann jedoch überall verwendet werden, wo ein UIElement verwendet werden kann. Die Hinweise gelten für alle Verwendungen.
Um ein BitmapIcon als Symbol für einen AppBarButton zu verwenden, geben Sie den URI einer Bilddatei an.
Die von Ihnen verwendete Datei sollte ein einfarbiges Bild auf einem transparenten Hintergrund sein. Es wird erwartet, dass das Bitmapbild, das vom Speicherort UriSource abgerufen wird, eine echte Bitmap mit transparenten Pixeln und nicht transparenten Pixeln ist. Das empfohlene Format ist PNG. Andere Bildquellen im Dateiformat werden scheinbar ohne Fehler geladen, führen jedoch zu einem vollfarbigen Block der Vordergrundfarbe im AppBarButton. Dieses Verhalten kann ignoriert werden, indem die ShowAsMonochrome-Eigenschaft auf false festgelegt wird.
Alle Farbinformationen werden aus der Bitmap entfernt, wenn das BitmapIcon gerendert wird. Die verbleibenden nicht transparenten Farben werden kombiniert, um ein Bild zu erzeugen, das vollständig die Vordergrundfarbe ist, wie sie von der Vordergrundeigenschaft festgelegt ist (dies stammt in der Regel aus Formatvorlagen oder Vorlagen, z. B. der Standardvorlage, die in eine Designressource aufgelöst wird). Sie können dieses Verhalten überschreiben, indem Sie die ShowAsMonochrome-Eigenschaft festlegen.
Der Wert der Foreground-Eigenschaft muss ein SolidColorBrush sein. Nachdem die Color-Eigenschaft des Vordergrunds gelesen wurde, werden Änderungen daran ignoriert. Um die Farbe zu ändern, müssen Sie den Wert der Vordergrundeigenschaft selbst in einen neuen SolidColorBrush ändern.
Hinweis
Sie können die Vordergrundeigenschaft im AppBarButton oder im BitmapIcon festlegen. Wenn Sie den Vordergrund auf appBarButton festlegen, wird er nur auf den standardmäßigen visuellen Zustand angewendet. Es wird nicht auf die anderen visuellen Zustände angewendet, die in der AppBarButton-Vorlage definiert sind, z. B MouseOver. . Wenn Sie den Vordergrund auf dem BitmapIcon festlegen, wird die Farbe auf alle visuellen Zustände angewendet.
Der Standardschriftgrad für ein AppBarButton-Symbol ist 20px.
Sie geben in der Regel einen UriSource-Wert an, der auf eine Bitmap verweist, die Sie als Teil der App, als Ressource oder anderweitig im App-Paket eingeschlossen haben. Weitere Informationen zu ms-appx: scheme und anderen URI-Schemas, die Sie verwenden können, um auf Ressourcen in Ihrer App zu verweisen, finden Sie unter Uri-Schemas.
Konstruktoren
| BitmapIcon() |
Initialisiert eine neue Instanz der BitmapIcon-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) |
| BaseUri |
Ruft einen Uniform Resource Identifier (URI) ab, der den Basis-URI für ein XAML-erstelltes Objekt zur XAML-Ladezeit darstellt. Diese Eigenschaft ist nützlich für die URI-Auflösung zur Laufzeit. (Geerbt von FrameworkElement) |
| CacheMode |
Ruft einen Wert ab, der angibt, dass gerenderter Inhalt nach Möglichkeit als zusammengesetzte Bitmap zwischengespeichert werden soll, oder legt diesen fest. (Geerbt von UIElement) |
| CanBeScrollAnchor |
Ruft einen Wert ab, der angibt, ob das UIElement ein Kandidat für scroll anchoring 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, d. h. der Punkt, an dem eine Drehung oder Skalierung stattfindet, oder legt diesen fest. Wirkt sich auf die Renderingposition des Elements aus. (Geerbt von UIElement) |
| Clip |
Ruft die RectangleGeometry ab, die zum Definieren der Gliederung des Inhalts eines UIElement verwendet wird, oder legt diese fest. (Geerbt von UIElement) |
| 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. (Geerbt von UIElement) |
| ContextFlyout |
Ruft das diesem Element zugeordnete Flyout ab oder legt es fest. (Geerbt von UIElement) |
| DataContext |
Ruft den Datenkontext für ein FrameworkElement ab oder legt diese fest. Eine häufige Verwendung eines Datenkontexts ist, wenn ein |
| DesiredSize |
Ruft die Größe ab, die dieses UIElement während des Measuredurchlaufs des Layoutprozesses berechnet hat. (Geerbt von UIElement) |
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft den |
| 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. (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 auf oder |
| FocusState |
Ruft einen Wert ab, der angibt, ob dieses Steuerelement den Fokus hat, und den Modus, mit dem der Fokus abgerufen wurde. (Geerbt von UIElement) |
| 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 |
| FocusVisualPrimaryThickness |
Ruft die Stärke des äußeren Rahmens eines Visuals oder |
| FocusVisualSecondaryBrush |
Ruft den Pinsel ab, der zum Zeichnen des inneren Rahmens eines Visuals oder |
| FocusVisualSecondaryThickness |
Ruft die Stärke des inneren Rahmens eines |
| Foreground |
Ruft einen Pinsel ab, der die Vordergrundfarbe beschreibt, oder legt diesen fest. (Geerbt von IconElement) |
| 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 enthaltene 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) |
| 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) |
| IsTabStop |
Ruft einen Wert ab, der angibt, ob ein Steuerelement in der Navigation mit der TAB-TASTE enthalten ist. (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 QuickInfo des Steuerelements die Tastenkombination für die zugeordnete Tastenkombination anzeigt, oder legt diesen fest. (Geerbt von UIElement) |
| KeyboardAcceleratorPlacementTarget |
Ruft einen Wert ab, der die QuickInfo des Steuerelements angibt, mit der die Tastenkombination angezeigt wird, oder legt diesen fest. (Geerbt von UIElement) |
| 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.
|
| 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. (Geerbt von UIElement) |
| 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. (Geerbt von UIElement) |
| KeyTipTarget |
Ruft einen Wert ab, der das Element angibt, auf das der Schlüsseltipp für den Zugriffsschlüssel abzielt, 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 von XamlLight-Objekten ab, die an dieses 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 den Wert fest. Das Festlegen dieses Werts ermöglicht die Behandlung der Bearbeitungsereignisse dieses Elements im App-Code. (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) |
| 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) |
| ProtectedCursor |
Ruft den Cursor ab, der angezeigt wird, wenn sich der Zeiger über dieses Element befindet, oder legt diesen fest. Standardmäßig null, was angibt, dass sich der Cursor nicht ändert. (Geerbt von UIElement) |
| RasterizationScale |
Ruft einen Wert ab, der die Anzahl der unformatierten (physischen) Pixel für jedes Ansichtspixel darstellt. (Geerbt von UIElement) |
| RenderSize |
Ruft die endgültige Rendergröße eines UIElement ab. Die Verwendung wird nicht empfohlen, siehe 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 beliebigen von RenderTransform deklarierten Rendertransform-Transformation relativ zu den Begrenzungen des UIElement ab 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, mit |
| Resources |
Ruft das lokal definierte Ressourcenwörterbuch ab. In XAML können Sie Ressourcenelemente als untergeordnete Objektelemente eines |
| Rotation |
Ruft den Winkel der Drehung im Uhrzeigersinn in Grad ab oder legt diesen 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 sie fest. (Geerbt von UIElement) |
| RotationTransition |
Ruft die ScalarTransition ab, die Änderungen an der Rotation-Eigenschaft animiert, oder legt sie fest. (Geerbt von UIElement) |
| Scale |
Ruft die Skalierung des Elements ab oder legt sie 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) |
| ShowAsMonochrome |
Ruft einen Wert ab, der angibt, ob die Bitmap in einer einzelnen Farbe angezeigt wird, oder legt diesen fest. |
| ShowAsMonochromeProperty |
Identifiziert die Abhängigkeitseigenschaft ShowAsMonochrome . |
| Style |
Ruft einen Instanzstil ab, der während des Layouts und Renderings für 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) |
| 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. (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) |
| UriSource |
Ruft den Uniform Resource Identifier (URI) der Bitmap ab, die als Symbolinhalt verwendet werden soll, oder legt diesen fest. |
| UriSourceProperty |
Gibt die UriSource-Abhängigkeitseigenschaft an. |
| UseLayoutRounding |
Ruft einen Wert ab, der bestimmt, ob das Rendering für das Objekt und seine visuelle Unterstruktur ein Rundungsverhalten verwenden soll, das das Rendering auf ganze Pixel ausrichtet, oder legt diesen fest. (Geerbt von UIElement) |
| UseSystemFocusVisuals |
Ruft einen Wert ab, der angibt, ob das Steuerelement Vom System gezeichnete Fokusvisuals oder Fokusvisuals verwendet, die in der Steuerelementvorlage definiert sind, oder legt diesen fest. (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 |
| Width |
Ruft die Breite eines FrameworkElements ab oder legt diese fest. (Geerbt von FrameworkElement) |
| XamlRoot |
Ruft die ab, in der |
| XYFocusDown |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer auf das Richtungspad (D-Pad) eines Spielcontrollers drückt, oder legt es 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) |
| XYFocusLeft |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer links auf das Richtungspad (D-Pad) eines Spielcontrollers drückt, oder legt es 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) |
| XYFocusRight |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer direkt auf das Richtungspad (D-Pad) eines Spielcontrollers drückt, oder legt es 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) |
| XYFocusUp |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer auf das Richtungspad (D-Pad) eines Spielcontrollers drückt, oder legt es 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 an |
| 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, das über capture verfügt, zeigerbezogene Ereignisse aus. (Geerbt von UIElement) |
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject) |
| FindName(String) |
Ruft ein Objekt ab, das über den angegebenen Bezeichnernamen verfügt. (Geerbt von FrameworkElement) |
| FindSubElementsForTouchTargeting(Point, Rect) |
Ermöglicht es einer UIElement-Unterklasse , untergeordnete Elemente verfügbar zu machen, die beim Auflösen der Touchadressierung helfen. (Geerbt von UIElement) |
| Focus(FocusState) |
Versucht, den Fokus auf dieses Element festzulegen. (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 , untergeordnete Elemente verfügbar zu machen, die am Tabstopp-Fokus teilnehmen. (Geerbt von UIElement) |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject) |
| GetVisualInternal() |
Ruft die |
| 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 Layout des UIElement aktualisiert, was asynchron erfolgt. (Geerbt von UIElement) |
| InvalidateMeasure() |
Ungültig wird der 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) |
Aktualisiert desiredSize eines UIElements. In der Regel rufen Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Layoutelemente implementieren, diese Methode aus ihren eigenen MeasureOverride-Implementierungen auf, um 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 BringIntoViewRequested-Ereignis auftritt. (Geerbt von UIElement) |
| OnCreateAutomationPeer() |
Gibt bei Implementierung in einer abgeleiteten Klasse klassenspezifische AutomationPeer-Implementierungen für die Microsoft-Benutzeroberflächenautomatisierungsinfrastruktur zurück. (Geerbt von UIElement) |
| 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. (Geerbt von UIElement) |
| 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. (Geerbt von UIElement) |
| 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. (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 diese DependencyObject-Instanz . (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 gehalten 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 dem 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(ExpPointerPoint) |
Stellt ein Symbol dar, das eine Bitmap als Inhalt verwendet. (Geerbt von UIElement) |
| 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. (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 einen Accelerator) 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 Nachfolger aufgerufen wird. (Geerbt von UIElement) |
| CharacterReceived |
Tritt auf, wenn ein einzelnes zusammengesetztes Zeichen von der Eingabewarteschlange empfangen wird. (Geerbt von UIElement) |
| 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 ansonsten nicht behandelte Hold-Interaktion über dem Treffertestbereich dieses Elements erfolgt. (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 losgelassen 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 mit einer Bearbeitung des 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 Tabstopp- oder Richtungspfeile), der Fokus jedoch nicht bewegt wird, weil 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 |
| 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 das 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 unbehandelte Tap-Interaktion über dem Treffertestbereich dieses Elements auftritt. (Geerbt von UIElement) |
| Unloaded |
Tritt auf, wenn dieses Objekt nicht mehr mit der Hauptobjektstruktur verbunden ist. (Geerbt von FrameworkElement) |