Image Klasse

Definition

Stellt ein Steuerelement dar, das ein Bild anzeigt. Die Bildquelle wird angegeben, indem auf eine Bilddatei verwiesen wird, die mehrere unterstützte Formate verwendet. 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, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Image final : FrameworkElement
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class Image final : FrameworkElement
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Image : FrameworkElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Image : FrameworkElement
Public NotInheritable Class Image
Inherits FrameworkElement
<Image .../>
Vererbung
Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement Image
Attribute

Windows-Anforderungen

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

Beispiele

Tipp

Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Bild.

Die App WinUI 2-Katalog umfasst interaktive Beispiele für die meisten WinUI 2-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.

Hinweise

Bilddateiformate

Ein Image 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)

Hinweis

Symboldateien werden nur unter Windows unterstützt. Nicht unterstützt in Windows Phone 8.1

Ab Windows 10 Version 1607 unterstützt das Image-Element animierte GIF-Bilder (Graphics Interchange Format). Wenn Sie bitmapImage als Bildquelle verwenden, können Sie auf die BitmapImage-API 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.

Hinweis

Die Gif-Unterstützung (Animated Graphics Interchange Format) ist verfügbar, wenn Ihre App für Windows 10, Version 1607, kompiliert und mit Version 1607 (oder höher) ausgeführt wird. Wenn Ihre App für frühere Versionen kompiliert ist oder in dieser ausgeführt wird, wird der erste Frame des Grafikaustauschformats (GIF) angezeigt, aber nicht animiert.

Ab Windows 10 Version 1703 unterstützt das Image-Element statische SVG-Images (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 spezifischen 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 .

Hinweis

Unterstützung für skalierbare Vektorgrafiken (Scalable Vector Graphics, SVG) ist verfügbar, wenn Ihre App für Windows 10, Version 1703, kompiliert und mit Version 1703 (oder höher) ausgeführt wird. Wenn Ihre App für frühere Versionen kompiliert wird oder ausgeführt wird, wird das SVG-Image nicht angezeigt.

Festlegen von Image.Source

Um die Bildquelldatei festzulegen, die von einem Image angezeigt wird, legen Sie die Source-Eigenschaft entweder in XAML oder im Code fest. Hier sehen 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 Uniform Resource Identifier (URI) 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 in den 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.

Wenn Sie die Quelle auf einen URI-Wert (Uniform Resource Identifier) festlegen, der nicht in eine gültige Bildquelldatei aufgelöst werden kann, wird keine Ausnahme ausgelöst. 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 es sich bei der Bildquelldatei um eine große Datei handelt 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. Das Festlegen der Image.Source-Eigenschaft erfordert eine instance der BitmapImage-Klasse, 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 URI (Uniform Resource Identifier) 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: dies geschieht automatisch, wenn Sie Source als XAML-Attribut angeben. Stattdessen müssen Sie explizit einen absoluten URI (Uniform Resource Identifier) mit dem entsprechenden Schema erstellen. In der Regel verwenden Sie das Schema ms-appx: für eine Bilddatei, die als Teil Ihrer App gepackt ist.

Tipp

Wenn Sie C# oder Microsoft Visual Basic verwenden, können Sie die BaseUri-Eigenschaft des Image abrufen und als baseUri-Parameter für System.Uri-Konstruktoren übergeben, die einen Basisspeicherort des 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 Bildquelle

Wenn es sich bei Der Bildquelle um einen Stream handelt, müssen Sie Code schreiben, der die Image-instance für die Verwendung des Datenstroms festlegt. Dies kann nicht allein in XAML erfolgen. Erstellen Sie das zu verwendende Image, oder verweisen Sie auf ein vorhandenes Image instance (das 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 einem Benutzer beispielsweise ermöglicht, eine Bilddatei mithilfe eines FileOpenPicker-Steuerelements auszuwählen, kann das Objekt, das die vom Benutzer ausgewählte Datei darstellt, als Stream geöffnet werden, stellt jedoch keinen URI-Verweis (Uniform Resource Identifier) auf die Datei bereit.

In diesem Beispiel ist der Code bereits erwartbar, da er darauf wartet, dass der Benutzer eine Datei auswählt und erst danach ausgeführt wird. Der zu verwendende Stream stammt aus StorageFile.OpenAsync, nachdem ein StorageFile-instance 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, den Sie möglicherweise aus früheren Microsoft .NET-Programmiererfahrungen kennen. Sie können die AsStream-Erweiterungsmethode als instance-Methode 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 vorhanden, um bei Bedarf in eine System.IO.Stream-Datei zu konvertieren.

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

Bilddateien und Leistung

Große Bilddateien können sich auf die Leistung auswirken, 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 Bild mit hoher Auflösung handelt, ihre App sie jedoch in einem Benutzeroberflächenbereich anzeigt, der 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 Speicherbedarf zu decodieren. Legen Sie DecodePixelWidth auf dieselbe Pixelbreite des Bereichs fest, den Ihre App tatsächlich anzeigen soll. Anders ausgedrückt: DecodePixelWidth für die BitmapImage-Quelle sollte denselben Wert wie width oderActualWidth des Image-Steuerelements haben, das diese Quelle anzeigt.

Sie können entweder 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 wie folgt ein explizites BitmapImage-Element als Eigenschaftselementwert enthält:

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

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

Wenn Sie ein Image-instance im Code erstellen, erstellen Sie wahrscheinlich bereits ein BitmapImage-instance als Wert, der für die Source-Eigenschaft bereitgestellt werden soll. Legen Sie daher einfach DecodePixelWidth (oder DecodePixelHeight) für die BitmapImage-instance 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 Imagequelleigenschaft aus dem URI (Uniform Resource Identifier) zu, anstatt nach Möglichkeit Speicherdatenströme zu verwenden. Das XAML-Framework kann denselben URI (Uniform Resource Identifier) an mehreren Stellen einem decodierten Bild zuordnen, aber es kann dies nicht für mehrere Speicherstreams tun, selbst wenn sie die gleichen 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 erleichtert die Verwendung der Klassen zum Erstellen der Benutzeroberfläche, 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 des Bilddateiformats 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 Eigenschaften Width und Height von FrameworkElement, und diese Eigenschaften steuern möglicherweise die Größe, die das Image-Steuerelement rendert, wenn es in der Benutzeroberfläche angezeigt wird. Wenn Sie keine Breite oder Höhe festlegen, werden 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 Bild-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 Anleitung verwenden und die andere dimensionieren, wobei das Seitenverhältnis beibehalten wird. Wenn Sie sich der Quelldateidimensionen nicht sicher sind, wählen Sie die Dimension aus, die in Ihrem Layoutszenario am wichtigsten ist, und lassen Sie das System die andere Dimension berechnen. Anschließend passt das Layoutverhalten des Containers in der Regel an die Anpassung des Layouts an.

Wenn Sie Breite und/oder Höhe nicht festlegen und das Bild die natürliche Größe beibehalten, kann die Stretch-Eigenschaft für das Bild steuern, wie die Bildquelldatei den von Ihnen als Breite und Höhe angegebenen Bereich ausfüllt. Der Standardmäßige Stretch-Wert ist Uniform, wodurch das Seitenverhältnis beibehalten wird, wenn das Bild in einen Layoutcontainer passt. Wenn die Abmessungen des Containers nicht das gleiche Seitenverhältnis aufweisen, gibt es einen leeren Bereich, der immer noch Teil von Image ist, aber keine Bildpixel anzeigt, zumindest bei Verwendung des Uniform-Werts für Stretch. UniformToFill für Stretch lässt keinen leeren Platz, sondern kann das Bild abschneiden, wenn die Abmessungen unterschiedlich sind. Durch Füllung für Stretch wird kein leerer Platz gelassen, aber das Seitenverhältnis kann sich ä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 eine Größe für ein Bild ohne bestimmte Breite und Höhe aufweisen, um den gesamten Layoutbereich auszufüllen. In diesem Fall können Sie bestimmte Größen für das Bild oder den Container festlegen.

NineGrid

Die Verwendung der NineGrid-Technik ist eine weitere Option für die Größenanpassung von Bildern, die eine andere natürliche Größe als Ihr Anzeigebereich haben, wenn das Bild Bereiche aufweist, die nicht einheitlich skaliert werden sollten. Sie können z. B. ein Hintergrundbild mit einem inhärenten Rahmen verwenden, der nur in einer Dimension gestreckt werden soll, und Ecken, die überhaupt nicht gestreckt werden sollen, aber die Bildmitte kann entsprechend den Layoutanforderungen in beiden Dimensionen gestreckt werden. Weitere Informationen finden Sie unter NineGrid.

Ressourcenqualifizierung und -lokalisierung für Image

Bildquelldateien und Skalierung

Sie sollten Ihre Bildquellen in mehreren empfohlenen Größen erstellen, um sicherzustellen, dass Ihre App gut aussieht, wenn Windows 8 sie skaliert. Wenn Sie eine Quelle für ein Image angeben, können Sie eine Namenskonvention 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 Namenskonventionen und weitere Informationen finden Sie unter Schnellstart: Verwenden von Datei- oder Bildressourcen.

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

Verwenden von nicht qualifizierten Ressourcen

Nicht qualifizierte Ressourcen sind eine Technik, die Sie verwenden können, wenn sich der Grundlegende Ressourcenverweis auf eine Standardressource bezieht und der Ressourcenverwaltungsprozess die entsprechende lokalisierte Ressource automatisch finden kann. Sie können die automatische Behandlung 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 das Bild flipping-Verhalten nur in Bildern, die für das Layout relevant sind, aber nicht unbedingt für Elemente mit eingebettetem Text oder anderen Komponenten, die für eine Rechts-nach-Links-Zielgruppe nicht sinnvoll sind. Zum Abrufen des Bildwendeverhaltens 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 nach x:Uid-Anweisung zu identifizieren und FlowDirection-Werte als Windows-Runtime-Ressource anzugeben, damit Ihre Lokalisierungsexperten diesen Wert später ändern können, ohne den XAML- oder Code zu ändern.

Image-Klasse und Barrierefreiheit

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

Windows 8-Verhaltensweise

Für Windows 8 können Ressourcen ein Ressourcenqualifizierermuster verwenden, um je nach gerätespezifischer Skalierung unterschiedliche Ressourcen zu laden. Ressourcen werden jedoch nicht automatisch neu geladen, wenn sich der Skalierungsfaktor ändert, während die App ausgeführt wird. In diesem Fall müssen Apps sich um das Erneute von Ressourcen kümmern, indem sie das DpiChanged-Ereignis (oder das veraltete LogicalDpiChanged-Ereignis ) behandeln und die ResourceManager-API verwenden, um die Ressource manuell neu zu laden, die für den neuen Skalierungsfaktor geeignet ist. Ab Windows 8.1 wird jede Ressource, die ursprünglich für Ihre App abgerufen wurde, 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, weil das System die neue Ressource anfordert und dann auf das Image anwendet. 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.

Wenn Sie Ihren App-Code von Windows 8 zu Windows 8.1 migrieren, sollten Sie diese Verhaltensänderung berücksichtigen, da dies zu ImageOpened- oder ImageFailed-Ereignissen führt, die zur Laufzeit auftreten, wenn die Skalierungsänderung behandelt wird, auch wenn die Quelle in XAML festgelegt ist. Wenn Sie über Code verfügen, der DpiChanged/LogicalDpiChanged verarbeitet und die Ressourcen zurückgesetzt hat, sollten Sie außerdem untersuchen, ob dieser Code angesichts des neuen Windows 8.1 automatischen Nachladenverhaltens weiterhin benötigt wird.

Apps, die für Windows 8 kompiliert wurden, aber unter Windows 8.1 ausgeführt werden, weisen weiterhin das Windows 8-Verhalten auf.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1607 14393 GetAlphaMask

Konstruktoren

Image()

Initialisiert eine neue instance der Image-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 (Uniform Resource Identifier) für ein XAML-erstelltes Objekt zur XAML-Ladezeit darstellt. Diese Eigenschaft ist nützlich für die URI-Auflösung (Uniform Resource Identifier) zur Laufzeit.

(Geerbt von FrameworkElement)
CacheMode

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

(Geerbt von UIElement)
CanBeScrollAnchor

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

(Geerbt von UIElement)
CanDrag

Ruft einen Wert ab, der angibt, ob das Element in einem Drag-and-Drop-Vorgang als Daten gezogen werden kann, oder legt diesen fest.

(Geerbt von UIElement)
CenterPoint

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

(Geerbt von UIElement)
Clip

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

(Geerbt von UIElement)
CompositeMode

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

(Geerbt von UIElement)
ContextFlyout

Ruft das flyout ab, das diesem Element zugeordnet ist, 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 ein FrameworkElement die { Binding}- Markuperweiterung verwendet und an der Datenbindung teilnimmt.

(Geerbt von FrameworkElement)
DesiredSize

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

(Geerbt von UIElement)
Dispatcher

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

(Geerbt von DependencyObject)
ExitDisplayModeOnAccessKeyInvoked

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

(Geerbt von UIElement)
FlowDirection

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

(Geerbt von FrameworkElement)
FocusVisualMargin

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

(Geerbt von FrameworkElement)
FocusVisualPrimaryBrush

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

(Geerbt von FrameworkElement)
FocusVisualPrimaryThickness

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

(Geerbt von FrameworkElement)
FocusVisualSecondaryBrush

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

(Geerbt von FrameworkElement)
FocusVisualSecondaryThickness

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

(Geerbt von FrameworkElement)
Height

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

(Geerbt von FrameworkElement)
HighContrastAdjustment

Ruft einen Wert ab, der angibt, ob das Framework die visuellen Eigenschaften des Elements automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind, oder legt diesen fest.

(Geerbt von UIElement)
HorizontalAlignment

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

(Geerbt von FrameworkElement)
IsAccessKeyScope

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

(Geerbt von UIElement)
IsDoubleTapEnabled

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

(Geerbt von UIElement)
IsHitTestVisible

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

(Geerbt von UIElement)
IsHoldingEnabled

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

(Geerbt von UIElement)
IsLoaded

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

(Geerbt von FrameworkElement)
IsRightTapEnabled

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

(Geerbt von UIElement)
IsTapEnabled

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

(Geerbt von UIElement)
KeyboardAcceleratorPlacementMode

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

(Geerbt von UIElement)
KeyboardAcceleratorPlacementTarget

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

(Geerbt von UIElement)
KeyboardAccelerators

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

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

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

(Geerbt von UIElement)
KeyTipHorizontalOffset

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

(Geerbt von UIElement)
KeyTipPlacementMode

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

(Geerbt von UIElement)
KeyTipTarget

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

(Geerbt von UIElement)
KeyTipVerticalOffset

Ruft einen Wert ab, der angibt, wie weit nach oben oder unten der Schlüsseltipp in Bezug auf das UI-Element platziert wird, oder legt diesen fest.

(Geerbt von UIElement)
Language

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

(Geerbt von FrameworkElement)
Lights

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

(Geerbt von UIElement)
ManipulationMode

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

(Geerbt von UIElement)
Margin

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

(Geerbt von FrameworkElement)
MaxHeight

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

(Geerbt von FrameworkElement)
MaxWidth

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

(Geerbt von FrameworkElement)
MinHeight

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

(Geerbt von FrameworkElement)
MinWidth

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

(Geerbt von FrameworkElement)
Name

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

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

(Geerbt von UIElement)
Parent

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

(Geerbt von FrameworkElement)
PlayToSource

Ruft die Informationen ab, die übertragen werden, wenn das Bild für ein Wiedergabeszenario verwendet wird.

PlayToSourceProperty

Gibt die PlayToSource-Abhängigkeitseigenschaft an.

PointerCaptures

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

(Geerbt von UIElement)
Projection

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

(Geerbt von UIElement)
RenderSize

Ruft die endgültige Rendergröße eines 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, das Sie mit RequestedTheme angeben, kann das Angeforderte Thema auf App-Ebene überschreiben.

(Geerbt von FrameworkElement)
Resources

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

(Geerbt von FrameworkElement)
Rotation

Ruft den 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)
Source

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

SourceProperty

Gibt die Source-Abhängigkeitseigenschaft an.

Stretch

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

StretchProperty

Gibt die Stretch-Abhängigkeitseigenschaft an.

Style

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

(Geerbt von FrameworkElement)
TabFocusNavigation

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

(Geerbt von UIElement)
Tag

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

(Geerbt von FrameworkElement)
Transform3D

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

(Geerbt von UIElement)
TransformMatrix

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

(Geerbt von UIElement)
Transitions

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

(Geerbt von UIElement)
Translation

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

(Geerbt von UIElement)
TranslationTransition

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

(Geerbt von UIElement)
Triggers

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

(Geerbt von FrameworkElement)
UIContext

Ruft den Kontextbezeichner für das -Element ab.

(Geerbt von UIElement)
UseLayoutRounding

Ruft einen Wert ab, der bestimmt, ob das 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)
VerticalAlignment

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

(Geerbt von FrameworkElement)
Visibility

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

(Geerbt von UIElement)
Width

Ruft die Breite eines FrameworkElements ab oder legt diese fest.

(Geerbt von FrameworkElement)
XamlRoot

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

(Geerbt von UIElement)
XYFocusDownNavigationStrategy

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

(Geerbt von UIElement)
XYFocusKeyboardNavigation

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

(Geerbt von UIElement)
XYFocusLeftNavigationStrategy

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

(Geerbt von UIElement)
XYFocusRightNavigationStrategy

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

(Geerbt von UIElement)
XYFocusUpNavigationStrategy

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

(Geerbt von UIElement)

Methoden

AddHandler(RoutedEvent, Object, Boolean)

Fügt einen Routingereignishandler für ein bestimmtes Routingereignis hinzu, wobei der Handler der Handlerauflistung für das aktuelle Element hinzugefügt wird. Geben Sie handledEventsToo als true an, damit der bereitgestellte Handler aufgerufen wird, auch wenn das Ereignis an anderer Stelle behandelt wird.

(Geerbt von UIElement)
Arrange(Rect)

Positioniert untergeordnete Objekte und bestimmt eine Größe für ein UIElement. Übergeordnete Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Elemente implementieren, sollten diese Methode aus ihren Layoutüberschreibungsimplementierungen aufrufen, um ein rekursives Layoutupdate zu bilden.

(Geerbt von UIElement)
ArrangeOverride(Size)

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

(Geerbt von FrameworkElement)
CancelDirectManipulations()

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

(Geerbt von UIElement)
CapturePointer(Pointer)

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

(Geerbt von UIElement)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Abhängigkeitseigenschaft.

(Geerbt von DependencyObject)
FindName(String)

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

(Geerbt von FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

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

(Geerbt von UIElement)
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 festgelegt wurde, was 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 das Verfügbarmachen untergeordneter Elemente, die am Tab-Fokus beteiligt sind.

(Geerbt von UIElement)
GetValue(DependencyProperty)

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

(Geerbt von DependencyObject)
GoToElementStateCore(String, Boolean)

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

(Geerbt von FrameworkElement)
InvalidateArrange()

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

(Geerbt von UIElement)
InvalidateMeasure()

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

(Geerbt von UIElement)
InvalidateViewport()

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

(Geerbt von FrameworkElement)
Measure(Size)

Updates die DesiredSize-Größe eines UIElements. In der Regel rufen Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Layoutelemente implementieren, diese Methode aus ihren eigenen MeasureOverride-Implementierungen auf, um ein rekursives Layoutupdate zu bilden.

(Geerbt von UIElement)
MeasureOverride(Size)

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

(Geerbt von FrameworkElement)
OnApplyTemplate()

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

(Geerbt von FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

Wird aufgerufen, bevor das Ereignis BringIntoViewRequested auftritt.

(Geerbt von UIElement)
OnCreateAutomationPeer()

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

(Geerbt von UIElement)
OnDisconnectVisualChildren()

Überschreiben Sie diese Methode, um zu implementieren, wie sich Layout und Logik verhalten sollen, wenn Elemente aus einer klassenspezifischen Inhalts- oder untergeordneten Eigenschaft entfernt werden.

(Geerbt von UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

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

(Geerbt von UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

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

(Geerbt von UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Definiert eine Eigenschaft, die animiert werden kann.

(Geerbt von UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

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

(Geerbt von UIElement)
ReadLocalValue(DependencyProperty)

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

(Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance.

(Geerbt von DependencyObject)
ReleasePointerCapture(Pointer)

Gibt Zeigererfassungen für die Erfassung eines bestimmten Zeigers durch dieses UIElement frei.

(Geerbt von UIElement)
ReleasePointerCaptures()

Gibt alle Zeigererfassungen frei, die von diesem Element 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(PointerPoint)

Leitet einen Drag & Drop-Vorgang ein.

(Geerbt von UIElement)
StopAnimation(ICompositionAnimationBase)

Beendet die angegebene Animation für das -Element.

(Geerbt von UIElement)
TransformToVisual(UIElement)

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

(Geerbt von UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

Versucht, eine Tastenkombination (oder 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 abhängigen Elemente 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 andernfalls unbehandelte Halteinteraktion über dem Treffertestbereich dieses Elements auftritt.

(Geerbt von UIElement)
ImageFailed

Tritt auf, wenn ein Fehler beim Abrufen oder Format von Bildern auftritt.

ImageOpened

Tritt auf, wenn die Bildquelle 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 freigegeben wird, während das UIElement den Fokus hat.

(Geerbt von UIElement)
LayoutUpdated

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

(Geerbt von FrameworkElement)
Loaded

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

(Geerbt von FrameworkElement)
Loading

Tritt auf, wenn ein FrameworkElement zu laden beginnt.

(Geerbt von FrameworkElement)
LosingFocus

Tritt auf, bevor ein UIElement den Fokus verliert. Dieses Ereignis wird synchron ausgelöst, um sicherzustellen, dass der Fokus nicht verschoben wird, während das Ereignis sprudelt.

(Geerbt von UIElement)
LostFocus

Tritt auf, wenn ein UIElement den Fokus verliert. Dieses Ereignis wird asynchron ausgelöst, sodass der Fokus erneut verschoben werden kann, bevor das Sprudeln abgeschlossen ist.

(Geerbt von UIElement)
ManipulationCompleted

Tritt auf, wenn eine Bearbeitung am UIElement abgeschlossen ist.

(Geerbt von UIElement)
ManipulationDelta

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

(Geerbt von UIElement)
ManipulationInertiaStarting

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

(Geerbt von UIElement)
ManipulationStarted

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

(Geerbt von UIElement)
ManipulationStarting

Tritt bei der ersten Erstellung des Manipulationsprozessors auf.

(Geerbt von UIElement)
NoFocusCandidateFound

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

(Geerbt von UIElement)
PointerCanceled

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

(Geerbt von UIElement)
PointerCaptureLost

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

(Geerbt von UIElement)
PointerEntered

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

(Geerbt von UIElement)
PointerExited

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

(Geerbt von UIElement)
PointerMoved

Tritt auf, wenn sich ein Zeiger bewegt, während der Zeiger im Treffertestbereich 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 beim Ende einer Press-Aktion nicht garantiert wird, dass ein PointerReleased-Ereignis ausgelöst wird. Andere Ereignisse können stattdessen ausgelöst werden. Weitere Informationen finden Sie unter Hinweise.

(Geerbt von UIElement)
PointerWheelChanged

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

(Geerbt von UIElement)
PreviewKeyDown

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

(Geerbt von UIElement)
PreviewKeyUp

Tritt auf, wenn eine Tastaturtaste freigegeben 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 Standard Objektstruktur verbunden ist.

(Geerbt von FrameworkElement)

Gilt für:

Weitere Informationen