Freigeben über


Image Klasse

Definition

Stellt ein Steuerelement dar, das ein Bild anzeigt. Die Bildquelle wird durch Verweisen auf eine Bilddatei mit mehreren unterstützten Formaten angegeben. Die Bildquelle kann auch mit einem Stream festgelegt werden. Die Liste der unterstützten Bildquellformate finden Sie unter Hinweise.

public ref class Image sealed : FrameworkElement
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [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 Image final : FrameworkElement
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[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 sealed class Image : FrameworkElement
Public NotInheritable Class Image
Inherits FrameworkElement
<Image .../>
Vererbung
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Image
Attribute

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Bilder und Bildpinsel.

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.

Hinweise

Bilddateiformate

Ein Bild kann die folgenden Bilddateiformate anzeigen:

  • JPEG (Joint Photographic Experts Group)
  • PNG (Portable Network Graphics)
  • BMP (Bitmap)
  • GIF (Graphics Interchange Format)
  • TIFF (Tagged Image File Format)
  • JPEG XR
  • ICO (Symbole)
  • Skalierbare Vektorgrafiken (SVG)

Das Image-Element unterstützt animierte GIF-Bilder (Graphics Interchange Format). Wenn Sie ein BitmapImage als Bildquelle verwenden, können Sie auf BitmapImage-APIs zugreifen, um die Wiedergabe des animierten GIF-Bilds (Graphics Interchange Format) zu steuern. Weitere Informationen findest du in den Anmerkungen auf der Seite für die BitmapImage-Klasse.

Das Image-Element unterstützt statische SVG-Bilder (Scalable Vector Graphics) über SvgImageSource. SvgImageSource unterstützt den sicheren statischen Modus aus der SVG-Spezifikation und unterstützt keine Animationen oder Interaktionen. Direct2D stellt die zugrunde liegende SVG-Renderingunterstützung bereit. Weitere Informationen zu bestimmten SVG-Elementen und Attributen finden Sie unter SVG-Unterstützung. Weitere Informationen zum Einfügen eines SVG in Ihre App finden Sie auf der SvgImageSource-Klassenseite .

Festlegen von Image.Source

Um die Bildquelldatei festzulegen, die von einem Bild angezeigt wird, legen Sie die Source-Eigenschaft entweder in XAML oder im Code fest. Im Folgenden finden Sie ein einfaches Beispiel für das Festlegen der Quelle in XAML:

<Image Width="200" Source="Images/myimage.png"/>

Bei dieser Verwendung wird source by Uniform Resource Identifier (URI) festgelegt. Dies ist eine Verknüpfung, die von XAML aktiviert wird. Beachten Sie, dass der URI (Uniform Resource Identifier) hier ein relativer URI (Uniform Resource Identifier) zu sein scheint. Die Unterstützung des partiellen URI (Uniform Resource Identifier) ist eine weitere XAML-Verknüpfung. Der Stamm dieses URI (Uniform Resource Identifier) ist der Basisordner für ein App-Projekt. Dies ist in der Regel derselbe Speicherort, aus dem die XAML-Datei mit dem Image-Tag geladen wird. In diesem Beispiel befindet sich die Bildquelldatei in einem Unterordner Images innerhalb der Dateistruktur der App.

Das Festlegen der Source-Eigenschaft ist inhärent eine asynchrone Aktion. Da es sich um eine Eigenschaft handelt, gibt es keine erwartbare Syntax, aber für die meisten Szenarien müssen Sie nicht mit den asynchronen Aspekten des Ladens von Bildern interagieren. Das Framework wartet auf die Rückgabe der Bildquelle und startet einen Layoutzyklus, wenn die Bildquelldatei verfügbar und decodiert ist.

Das Festlegen der Quelle auf einen URI-Wert (Uniform Resource Identifier), der nicht in eine gültige Bildquelldatei aufgelöst werden kann, löst keine Ausnahme aus. Stattdessen wird ein ImageFailed-Ereignis ausgelöst . Sie können einen ImageFailed-Handler schreiben und an das Image-Objekt anfügen, und möglicherweise die ErrorMessage in Ereignisdaten verwenden, um die Art des Fehlers zu bestimmen. Ein Fehler bei der Decodierung kann auch ImageFailed auslösen. Wenn Sie überprüfen möchten, ob eine Bildquelldatei ordnungsgemäß geladen wurde, können Sie das ImageOpened-Ereignis für das Image-Element behandeln.

In der Regel verwenden Sie Bildquelldateien, die Sie als Teil Ihres App-Downloadpakets eingeschlossen haben. Bei großen Dateien kann es zu einer sehr geringen Verzögerung kommen, während die Bildquelldatei decodiert wird, wenn dies das erste Mal ist, dass die Quelle verwendet wird. Weitere Informationen zu App-Ressourcen und zum Verpacken von Bildquelldateien in einem App-Paket finden Sie unter Definieren von App-Ressourcen.

Sie können auch Bildquelldateien verwenden, die nicht Teil der App sind, z. B. Bilder von externen Servern. Diese Images werden von einer internen HTTP-Anforderung heruntergeladen und dann decodiert. Wenn die Bildquelldatei eine große Datei ist oder Verbindungsprobleme auftreten, kann es zu einer Verzögerung kommen, bevor ein externes Bild in einem Image-Element angezeigt werden kann.

Festlegen von Image.Source mithilfe von Code

Wenn Sie ein Image-Objekt mithilfe von Code erstellen, rufen Sie den Standardkonstruktor auf, und legen Sie dann die Image.Source-Eigenschaft fest. Wenn Sie die Image.Source-Eigenschaft festlegen, ist eine Instanz der BitmapImage-Klasse erforderlich, die Sie auch erstellen müssen. Wenn ihre Bildquelle eine Datei ist, auf die vom Uniform Resource Identifier (URI) verwiesen wird, verwenden Sie den BitmapImage-Konstruktor , der einen URI-Parameter (Uniform Resource Identifier) akzeptiert. Wenn Sie auf lokalen Inhalt verweisen, müssen Sie das Schema ms-appx: in den absoluten Uniform Resource Identifier (URI) einschließen, den Sie als BitmapImage-Konstruktorparameter verwenden. Im Code erhalten Sie nicht die Verarbeitungsverknüpfungen für die Kombination relativer URI-Teile (Uniform Resource Identifier) und des Schemas ms-appx: , das automatisch erfolgt, wenn Sie Source als XAML-Attribut angeben. Stattdessen müssen Sie explizit einen absoluten URI (Uniform Resource Identifier) mit dem entsprechenden Schema erstellen. Sie verwenden in der Regel das Schema ms-appx: für eine Bilddatei, die als Teil Ihrer App gepackt wird.

Tipp

Wenn Sie C# verwenden, können Sie die BaseUri-Eigenschaft des Image abrufen und diese als baseUri-Parameter für System.Uri-Konstruktoren übergeben, die einen Basisspeicherort (Uniform Resource Identifier, URI) und einen relativen Pfad innerhalb dieses Speicherorts kombinieren.

Hier sehen Sie ein Beispiel für das Festlegen von Image.Source in C#. In diesem Beispiel wurde das Image-Objekt in XAML erstellt, verfügt aber nicht über eine Quelle oder andere Eigenschaftswerte. stattdessen werden diese Werte zur Laufzeit bereitgestellt, wenn das Image aus XAML geladen wird.

void Image_Loaded(object sender, RoutedEventArgs e)
{
    Image img = sender as Image; 
    BitmapImage bitmapImage = new BitmapImage();
    img.Width = bitmapImage.DecodePixelWidth = 80; //natural px width of image source
    // don't need to set Height, system maintains aspect ratio, and calculates the other
    // dimension, so long as one dimension measurement is provided
    bitmapImage.UriSource = new Uri(img.BaseUri,"Assets/StoreLogo.png");
    img.Source = bitmapImage;
}

Verwenden einer Streamquelle für eine Imagequelle

Wenn es sich bei Ihrer Bildquelle um einen Stream handelt, müssen Sie Code schreiben, der die Verwendung des Datenstroms für Ihre Image-Instanz festlegt. Dies kann nicht allein in XAML erfolgen. Erstellen Sie das Image, das verwendet werden soll, oder verweisen Sie auf eine vorhandene Image-Instanz (die möglicherweise im XAML-Markup definiert wurde, aber ohne Quelle). Verwenden Sie dann die asynchrone SetSourceAsync-Methode von BitmapImage , um die Bildinformationen aus einem Stream zu definieren, und übergeben Sie den Stream, der als streamSource-Parameter verwendet werden soll. Die Verwendung eines Datenstroms für eine Bildquelle ist ziemlich häufig. Wenn Ihre App es beispielsweise einem Benutzer ermöglicht, eine Bilddatei mithilfe eines FileOpenPicker-Steuerelements auszuwählen, kann das Objekt, das sie erhalten, das die vom Benutzer ausgewählte Datei darstellt, als Stream geöffnet werden, aber keinen URI (Uniform Resource Identifier) verweis auf die Datei.

In diesem Beispiel ist der Code bereits abwartbar, da er darauf wartet, dass der Benutzer eine Datei auswählt und erst danach ausgeführt wird. Der zu verwendende Stream stammt von StorageFile.OpenAsync , nachdem eine StorageFile-Instanz von den asynchronen Auswahlaktionen zurückgegeben wurde.

FileOpenPicker open = new FileOpenPicker(); 
// Open a stream for the selected file 
StorageFile file = await open.PickSingleFileAsync(); 
// Ensure a file was selected 
if (file != null) 
{ 
    using (IRandomAccessStream fileStream = await file.OpenAsync(Windows.Storage.FileAccessMode.Read)) 
    { 
        // Set the image source to the selected bitmap 
         BitmapImage bitmapImage = new BitmapImage(); 
         bitmapImage.DecodePixelWidth = 600; //match the target Image.Width, not shown
         await bitmapImage.SetSourceAsync(fileStream); 
         Scenario2Image.Source = bitmapImage; 
    } 
}

Tipp

Wenn Sie C# oder Microsoft Visual Basic verwenden, können Streams den System.IO.Stream-Typ verwenden, mit dem Sie möglicherweise aus früheren Microsoft .NET-Programmiererfahrungen vertraut sind. Sie können die AsStream-Erweiterungsmethode als Instanzmethode für jedes Objekt des Typs IRandomAccessStream aufrufen, das Sie von einer Windows-Runtime-API abgerufen haben. Im vorherigen Beispiel wurde IRandomAccessStream für die Parameterübergabe verwendet, und asStream musste nicht verwendet werden. Wenn Sie den Stream jedoch jemals bearbeiten müssen, ist AsStream als Hilfsprogramm für die Konvertierung in eine System.IO.Stream-Datei vorhanden, wenn Sie ihn benötigen.

Weitere Beispielcode finden Sie im Beispiel für XAML-Bilder .

Bilddateien und Leistung

Große Bilddateien können die Leistung beeinträchtigen, da sie in den Arbeitsspeicher geladen werden. Wenn Sie auf eine Bilddatei verweisen, in der Sie wissen, dass es sich bei der Quelldatei um ein großes, hochauflösendes Bild handelt, ihre App es jedoch in einer Benutzeroberflächenregion anzeigt, die kleiner als die natürliche Größe des Bilds ist, sollten Sie die DecodePixelWidth-Eigenschaft oder DecodePixelHeight festlegen. Mit den DecodePixel*-Eigenschaften können Sie Informationen direkt an den formatspezifischen Codec übergeben, und der Codec kann diese Informationen verwenden, um effizienter und auf einen geringeren Arbeitsspeicherbedarf zu decodieren. Legen Sie DecodePixelWidth auf die gleiche Pixelbreite des Bereichs fest, den Ihre App tatsächlich anzeigen soll. Mit anderen Worten: DecodePixelWidth für die BitmapImage-Quelle sollte den gleichen Wert wie die Width oder ActualWidth des Image-Steuerelements haben, das diese Quelle anzeigt.

Sie können decodePixelWidth oder DecodePixelHeight festlegen. Wenn Sie eine dieser beiden Eigenschaften festlegen, berechnet das System die übereinstimmende Eigenschaft, um das richtige Seitenverhältnis beizubehalten. Sie können auch beide Eigenschaften festlegen, aber Sie sollten in der Regel Werte verwenden, die dieses Seitenverhältnis beibehalten. Wenn Sie Seitenverhältnisse ändern möchten, gibt es bessere Möglichkeiten, dies zu tun, z. B. die Verwendung einer TranslateTransform als RenderTransform.

Um DecodePixelWidth (oder DecodePixelHeight) in XAML festzulegen, müssen Sie eine etwas ausführlichere XAML-Syntax verwenden, die ein explizites BitmapImage-Element als Eigenschaftselementwert wie folgt enthält:

<Image>
  <Image.Source>
    <BitmapImage DecodePixelWidth="200" UriSource="images/myimage.png"/>
  </Image.Source>
</Image>

DecodePixelWidth (oder DecodePixelHeight) sind Eigenschaften von BitmapImage. Daher benötigen Sie ein explizites BitmapImage-XAML-Objektelement, um die DecodePixel*-Eigenschaften als Attribute in XAML festzulegen.

Wenn Sie eine Image-Instanz im Code erstellen, erstellen Sie wahrscheinlich bereits eine BitmapImage-Instanz als Wert für die Source-Eigenschaft . Legen Sie also einfach DecodePixelWidth (oder DecodePixelHeight) für die BitmapImage-Instanz fest, bevor Sie die UriSource-Eigenschaft festlegen. Die DecodePixelType-Eigenschaft wirkt sich auch auf die Interpretation von Pixelwerten durch die Decodierungsvorgänge aus.

Um zu verhindern, dass Bilder mehr als einmal decodiert werden, weisen Sie die Bildquelleigenschaft von Uniform Resource Identifier (URI) zu, anstatt Speicherdatenströme zu verwenden, wann immer möglich. Das XAML-Framework kann denselben Uniform Resource Identifier (URI) an mehreren Stellen einem decodierten Bild zuordnen, aber es kann dies nicht für mehrere Speicherdatenströme tun, auch wenn sie dieselben Daten enthalten.

Sie können Bilddateien aus dem Imagecache entfernen, indem Sie alle zugeordneten Image.Source-Werte auf NULL festlegen.

Weitere Informationen zur Image-Klasse und -Leistung finden Sie unter Optimieren von Animationen und Medien.

Codierung und Decodierung von Bilddateien

Die zugrunde liegende Codecunterstützung für Bilddateien wird von der WIC-API (Windows Imaging Component) bereitgestellt. Weitere Informationen zu bestimmten Bildformaten, die für die Codecs dokumentiert sind, finden Sie unter Native WIC-Codecs.

Die API für Image, BitmapImage und BitmapSource enthält keine dedizierten Methoden zum Codieren und Decodieren von Medienformaten. Alle Decodierungsvorgänge sind als Aktionen integriert, die auftreten, wenn die Quelle festgelegt oder zurückgesetzt wird. Dies macht die Verwendung der Klassen zum Erstellen der Benutzeroberfläche einfacher, da sie über einen Standardsatz von unterstützten Quelldateiformaten und Decodierungsverhalten verfügen. Klassen wie BitmapImage machen einige decodierungsoptionen und logik als Teil von Ereignisdaten für ImageOpened - oder ImageFailed-Ereignisse verfügbar . Wenn Sie eine erweiterte Bilddateidecodierung oder Bildcodierung benötigen, sollten Sie die API aus dem Windows.Graphics.Imaging-Namespace verwenden. Möglicherweise benötigen Sie diese API, wenn Ihr App-Szenario Konvertierungen von Bilddateiformaten oder die Bearbeitung eines Bilds umfasst, bei dem der Benutzer das Ergebnis als Datei speichern kann. Die Codierungs-API wird auch von der WiC-Komponente (Windows Imaging Component) von Windows unterstützt.

Bildbreite und -höhe

Die Image-Klasse erbt die Width - und Height-Eigenschaften von FrameworkElement, und diese Eigenschaften steuern möglicherweise die Größe, die ihr Image-Steuerelement rendert, wenn es auf der Benutzeroberfläche angezeigt wird. Wenn Sie keine Breite oder Höhe festlegen, wird die Breite und Höhe durch die natürliche Größe der Bildquelle bestimmt. Wenn Sie beispielsweise ein Bitmapbild laden, das 300 Pixel hoch und 400 Pixel breit ist, wie im Quelldateiformat aufgezeichnet, werden diese Messungen für die Breite und Höhe verwendet, wenn das Image-Steuerelement seine natürliche Größe berechnet. Sie können ActualHeight und ActualWidth zur Laufzeit überprüfen, nachdem das Bild gerendert wurde, um die Messinformationen abzurufen. Oder Sie können ImageOpened behandeln und Bilddateieigenschaften wie PixelHeight und PixelWidth direkt vor dem Rendern des Bilds überprüfen.

Wenn Sie nur eine der Eigenschaften Width oder Height festlegen, aber nicht beide, kann das System diese Dimension als Orientierungshilfe verwenden und die andere Dimension berechnen, wobei das Seitenverhältnis beibehalten wird. Wenn Sie sich mit den Quelldateidimensionen nicht sicher sind, wählen Sie die Dimension aus, die in Ihrem Layoutszenario am wichtigsten zu steuern ist, und lassen Sie das System die andere Dimension berechnen, und dann passt das Layoutverhalten des Containers in der Regel das Layout an.

Wenn Sie Breite und/oder Höhe nicht festlegen und das Bild als natürliche Größe belassen, kann die Stretch-Eigenschaft für das Bild steuern, wie die Bildquelldatei den als Breite und Höhe angegebenen Raum füllt. Der Standard-Stretch-Wert ist Uniform, wodurch das Seitenverhältnis beibehalten wird, wenn das Bild in einen Layoutcontainer eingefügt wird. Wenn die Dimensionen des Containers nicht das gleiche Seitenverhältnis aufweisen, gibt es einen leeren Bereich, der weiterhin Teil von Image ist, aber keine Bildpixel anzeigt, zumindest wenn der Uniform-Wert für Stretch verwendet wird. UniformToFill für Stretch lässt keinen leeren Platz, sondern kann das Bild ausschneiden, wenn sich die Dimensionen unterscheiden. Füllen für Stretch lässt keinen leeren Platz, sondern kann das Seitenverhältnis ändern. Sie können mit diesen Werten experimentieren, um zu ermitteln, was für die Bildanzeige in Ihrem Layoutszenario am besten geeignet ist. Beachten Sie außerdem, dass bestimmte Layoutcontainer möglicherweise ein Bild groß dimensionieren, das keine bestimmte Breite und Höhe aufweist, um den gesamten Layoutraum auszufüllen. In diesem Fall können Sie bestimmte Größen für das Image oder den Container festlegen.

NineGrid

Die Verwendung der NineGrid-Technik ist eine weitere Option zum Skalieren von Bildern, die eine andere natürliche Größe als Ihr Anzeigebereich haben, wenn das Bild Regionen aufweist, die nicht einheitlich skaliert werden sollten. Sie können beispielsweise ein Hintergrundbild mit einem inhärenten Rahmen verwenden, der sich nur in einer Dimension erstrecken sollte, und Ecken, die sich überhaupt nicht dehnen sollten, aber das Bildzentrum kann sich dehnen, um die Layoutanforderungen in beiden Dimensionen zu erfüllen. Weitere Informationen finden Sie unter NineGrid.

Ressourcenqualifizierung und Lokalisierung für Image

Bildquelldateien und Skalierung

Erstellen Sie Ihre Bildquellen in mehreren empfohlenen Größen, damit die App immer gut aussieht, wenn Windows sie skaliert. Wenn Sie eine Quelle für ein Image angeben, können Sie eine Benennungskonvention für Ressourcen verwenden, die die richtige Ressource für gerätespezifische Skalierungsfaktoren verwenden. Dies wird von der App automatisch zur Laufzeit bestimmt. Einzelheiten zu den zu verwendenden Benennungskonventionen und weitere Informationen finden Sie unter Schnellstart: Verwenden von Datei- oder Bildressourcen.

Weitere Informationen zum richtigen Entwerfen von Bildern für die Skalierung finden Sie unter UX-Richtlinien für Layout und Skalierung.

Verwenden nicht qualifizierter Ressourcen

Nicht qualifizierte Ressourcen sind eine Technik, die Sie verwenden können, wenn der grundlegende Ressourcenverweis auf eine Standardressource verweist, und der Ressourcenverwaltungsprozess die entsprechende lokalisierte Ressource automatisch finden kann. Sie können die automatische Verarbeitung für den Zugriff auf nicht qualifizierte Ressourcen mit aktuellen Skalierungs- und Kulturqualifizierern verwenden, oder Sie können ResourceManager und ResourceMap mit Qualifizierern für Kultur und Skalierung verwenden, um die Ressourcen direkt abzurufen. Weitere Informationen finden Sie unter Ressourcenverwaltungssystem.

FlowDirection für Image

Wenn Sie FlowDirection für ein Bild auf RightToLeft festlegen, wird der visuelle Inhalt eines Bilds horizontal gekippt. Ein Image-Element erbt jedoch nicht den FlowDirection-Wert von einem übergeordneten Element. In der Regel möchten Sie nur Bild-Flipping-Verhalten in Bildern, die für das Layout relevant sind, aber nicht notwendigerweise für Elemente mit eingebettetem Text oder anderen Komponenten, die für eine Rechts-nach-Links-Zielgruppe nicht sinnvoll sind. Um das Bild-Flip-Verhalten zu erhalten, müssen Sie das FlowDirection-Element für das Image-Element speziell auf RightToLeft festlegen oder die FlowDirection-Eigenschaft im CodeBehind festlegen. Erwägen Sie, das Image-Element anhand der x:Uid-Direktive zu identifizieren und FlowDirection-Werte als Windows-Runtime-Ressource anzugeben, damit Ihre Lokalisierungsexperten diesen Wert später ändern können, ohne xaml oder code zu ändern.

Image-Klasse und Barrierefreiheit

Die Image-Klasse ist keine echte Steuerelementklasse, da sie keine Nachfolgerklasse von Control ist. Sie können den Fokus für ein Image-Element nicht aufrufen oder ein Image-Element in einer Registerkartensequenz platzieren. Weitere Informationen zu den Barrierefreiheitsaspekten bei der Verwendung von Bildern und dem Image-Element auf Der Benutzeroberfläche finden Sie unter Grundlegende Informationen zur Barrierefreiheit.

Bildressourcen

Ressourcen können ein Ressourcenqualifizierermuster verwenden, um je nach gerätespezifischer Skalierung verschiedene Ressourcen zu laden. Alle Ressourcen, die ursprünglich für Ihre App abgerufen wurden, werden automatisch neu ausgewertet, wenn sich der Skalierungsfaktor ändert, während die App ausgeführt wird. Wenn diese Ressource die Bildquelle für ein Image-Objekt ist, wird eines der Quellladeereignisse (ImageOpened oder ImageFailed) ausgelöst, als Ergebnis der Systemaktion, die neue Ressource anzufordern und dann auf das Image anzuwenden. Das Szenario, in dem eine Änderung der Laufzeitskalierung auftreten kann, ist, wenn der Benutzer Ihre App auf einen anderen Monitor verschiebt, wenn mehrere verfügbar sind. Daher können ImageOpened - oder ImageFailed-Ereignisse zur Laufzeit auftreten, wenn die Skalierungsänderung behandelt wird, auch wenn die Quelle in XAML festgelegt ist.

Konstruktoren

Image()

Initialisiert eine neue Instanz der Image-Klasse .

Eigenschaften

AccessKey

Ruft den Zugriffsschlüssel (mnemonisch) 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 FrameworkElements ab. Siehe Hinweise.

(Geerbt von FrameworkElement)
ActualOffset

Ruft die Position dieses UIElements relativ zum übergeordneten Element ab, das während des Anordnens 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 von der RequestedTheme unterscheiden kann.

(Geerbt von FrameworkElement)
ActualWidth

Ruft die gerenderte Breite eines FrameworkElements 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 ihn fest.

(Geerbt von UIElement)
AllowFocusOnInteraction

Ruft einen Wert ab, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer mit dem Element 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 URI (Uniform Resource Identifier) ab, der den Basis-URI für ein XAML-konstruiertes Objekt zur XAML-Ladezeit darstellt. Diese Eigenschaft ist für die URI-Auflösung zur Laufzeit nützlich.

(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. Ein Datenkontext wird häufig verwendet, wenn die FrameworkElement{Binding}- Markuperweiterung verwendet wird und an der Datenbindung beteiligt ist.

(Geerbt von FrameworkElement)
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 null . Verwenden Sie stattdessen DispatcherQueue .

(Geerbt von DependencyObject)
DispatcherQueue

Ruft den DispatcherQueue ab, dem dieses Objekt zugeordnet ist. Stellt DispatcherQueue eine Funktion dar, die auf den 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 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 innerhalb eines übergeordneten Elements fließen, das das Layout steuert, oder legt diese fest. Diese Eigenschaft kann auf oder LeftToRightRightToLeftfestgelegt werden. Wenn Sie für jedes Element auf RightToLeft festlegenFlowDirection, wird die Ausrichtung nach rechts, die Leserichtung von rechts nach links und das Layout des Steuerelements festgelegt, das von rechts nach links fließen soll.

(Geerbt von FrameworkElement)
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 HighVisibility Visuals oder Reveal eines Fokusvisuals für ein FrameworkElement verwendet wird, oder legt diesen fest.

(Geerbt von FrameworkElement)
FocusVisualPrimaryThickness

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

(Geerbt von FrameworkElement)
FocusVisualSecondaryBrush

Ruft den Pinsel ab, der verwendet wird, um den inneren Rahmen eines Oder Fokusvisuals HighVisibility für ein FrameworkElement zu zeichnen, oder Reveal legt diesen fest.

(Geerbt von FrameworkElement)
FocusVisualSecondaryThickness

Ruft die Stärke des inneren Rahmens eines oder Reveal eines HighVisibility 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 Ausrichtungsmerkmale ab, die auf ein FrameworkElement angewendet werden, wenn es in einem übergeordneten Layout zusammengesetzt wird, z. B. einem Panel- oder Elementsteuerelement.

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

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

(Geerbt von UIElement)
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-/Globalisierungssprachinformationen 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öheeinschränkung eines FrameworkElements 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 FrameworkElements 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 diese 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)
NineGrid

Ruft einen Wert für eine Metapher mit neun Rastern ab, die steuert, wie die Größe des Bilds geändert werden kann, oder legt diesen fest. Die Metapher mit neun Rastern ermöglicht es Ihnen, Kanten und Ecken eines Bilds anders als seine Mitte zu strecken. Weitere Informationen und eine Abbildung finden Sie unter Hinweise.

NineGridProperty

Identifiziert die NineGrid-Abhängigkeitseigenschaft .

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 diesem Element befindet, oder legt diesen fest. Der Standardwert ist 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 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 Ressourcenbestimmung verwendet wird, oder legt es fest. Das UI-Design, das Sie mit RequestedTheme angeben, kann die RequestedTheme auf App-Ebene überschreiben.

(Geerbt von FrameworkElement)
Resources

Ruft das lokal definierte Ressourcenverzeichnis ab. In XAML können Sie Ressourcenelemente als untergeordnete Objektelemente eines frameworkElement.Resources Eigenschaftselements mithilfe der impliziten XAML-Sammlungssyntax 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)
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)
Source

Ruft die Quelle für das Bild ab oder legt sie fest.

SourceProperty

Identifiziert die Source-Abhängigkeitseigenschaft .

Stretch

Ruft einen Wert ab, der beschreibt, wie ein Bild gestreckt werden soll, um das Zielrechteck auszufüllen, oder legt diesen fest.

StretchProperty

Identifiziert die Stretch-Abhängigkeitseigenschaft.

Style

Ruft einen Instanzstil 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)
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)
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)
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.

(Geerbt von UIElement)
VerticalAlignment

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

(Geerbt von FrameworkElement)
Visibility

Ruft die Sichtbarkeit eines UIElements ab oder legt diese fest. Ein UIElement nicht sichtbarer 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)
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.

(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 nach links auf das Directional Pad (D-Pad) eines Gamecontrollers 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 Directional Pad (D-Pad) eines Gamecontrollers 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 Directional Pad (D-Pad) eines Gamecontrollers 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 handledEventsToo als true an, damit der bereitgestellte Handler aufgerufen werden soll, 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 eine rekursive Layoutaktualisierung 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 "Arrange"-Passverhalten 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)
GetAlphaMask()

Gibt eine Maske zurück, die den Alphakanal eines Bilds als CompositionBrush darstellt.

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)
GetAsCastingSource()

Gibt das Bild als CastingSource zurück.

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 Visual ab, in die das Element aufgelöst wird.

(Geerbt von UIElement)
GoToElementStateCore(String, Boolean)

Aktiviert bei Implementierung in einer abgeleiteten Klasse die Erstellung einer visuellen Struktur pro Zustand für eine Steuerelementvorlage im Code, 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ültig wird der Viewportzustand 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 aufgerufen, wenn Anwendungscode oder interne Prozesse (z. B. ein neuerstellender Layoutdurchlauf) ApplyTemplate aufrufen. Vereinfacht 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 auf dieser 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 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 eine Bindung mithilfe des bereitgestellten Bindungsobjekts 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(ExpPointerPoint)

Stellt ein Steuerelement dar, das ein Bild anzeigt. Die Bildquelle wird durch Verweisen auf eine Bilddatei mit mehreren unterstützten Formaten angegeben. Die Bildquelle kann auch mit einem Stream festgelegt werden. Die Liste der unterstützten Bildquellformate finden Sie unter Hinweise.

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

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

(Geerbt von UIElement)

Ereignisse

AccessKeyDisplayDismissed

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

(Geerbt von UIElement)
AccessKeyDisplayRequested

Tritt auf, wenn der Benutzer anfordert, dass Zugriffsschlüssel angezeigt werden.

(Geerbt von UIElement)
AccessKeyInvoked

Tritt auf, wenn ein Benutzer eine Zugriffstastensequenz 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)
ImageFailed

Tritt auf, wenn ein Fehler im Zusammenhang mit dem Bildabruf oder -format auftritt.

ImageOpened

Tritt auf, wenn die Imagequelle heruntergeladen und ohne Fehler decodiert wird. Sie können dieses Ereignis verwenden, um die natürliche Größe der Bildquelle zu bestimmen.

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 PointerReleased Ereignis auslöst. Stattdessen können andere Ereignisse 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 Hauptobjektstruktur verbunden ist.

(Geerbt von FrameworkElement)

Gilt für:

Weitere Informationen