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 Datenstrom festgelegt werden. Die Liste der unterstützten Bildquellenformate finden Sie in den Hinweisen.

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

Tip

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

Die WinUI 3 Gallery-App enthält interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Holen Sie sich die App aus dem Microsoft Store oder holen Sie sich den Quellcode auf GitHub.

Hinweise

Bilddateiformate

Ein Bild kann diese Bilddateiformate anzeigen:

  • Gemeinsame Expertenkommission für Fotografie (JPEG)
  • Portable Netzwerkgrafik (PNG)
  • Bitmap (BMP)
  • Graphics Interchange Format (GIF) – ein Grafikformat für den Austausch von Bildern
  • Tagged Image Dateiformat (TIFF)
  • JPEG XR
  • Symbole (ICO)
  • 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 und weitere Informationen zu bestimmten SVG-Elementen und Attributunterstützung zur Seite, siehe SVG-Support. Weitere Informationen zum Einfügen eines SVG in Ihre App finden Sie auf der SvgImageSource-Klassenseite .

Festlegen von Image.Source

Wenn Sie die Bildquelldatei festlegen möchten, die von einem Bild angezeigt wird, legen Sie dessen Source-Eigenschaft entweder in XAML oder im Code fest. Hier ist ein einfaches Beispiel für das Festlegen der Quelle in XAML:

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

Bei dieser Verwendung wird die Quelle durch uniform Resource Identifier (URI) festgelegt, bei der es sich um eine Verknüpfung handelt, die von XAML aktiviert ist. Beachten Sie, dass hier der URI (Uniform Resource Identifier) als relativer URI (Uniform Resource Identifier) angezeigt wird; Unterstützung partieller 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" in 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 erwartete 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.

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 enthalten haben. Bei großen Dateien kann es eine sehr kleine Verzögerung geben, während die Bildquelldatei decodiert wird, wenn dies das erste Mal ist, wenn 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 Bilder 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 mit Code erstellen, rufen Sie den Standardkonstruktor auf, und legen Sie dann die Image.Source-Eigenschaft fest. Das Festlegen der Image.Source-Eigenschaft erfordert eine Instanz der BitmapImage-Klasse , die Sie auch erstellen müssen. Wenn die Bildquelle eine Datei ist, auf die durch uniform Resource Identifier (URI) verwiesen wird, verwenden Sie den BitmapImage-Konstruktor , der einen URI -Parameter (Uniform Resource Identifier) verwendet. Wenn Sie auf lokale Inhalte 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 keine Verarbeitungsverknüpfungen zum Kombinieren relativer URI-Teile (Uniform Resource Identifier) und des ms-appx:- Schemas, das automatisch auftritt, 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 wird.

Tip

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 URI-Basisspeicherort (Uniform Resource Identifier) und einen relativen Pfad innerhalb dieses Speicherorts kombinieren.

Hier ist ein Beispiel für das Festlegen von Image.Source in C#. In diesem Beispiel wurde das Image-Objekt in XAML erstellt, verfügt jedoch nicht über eine Quelle oder andere Eigenschaftswerte. Stattdessen werden diese Werte zur Laufzeit bereitgestellt, wenn das Bild 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 Datenstrom handelt, müssen Sie Code schreiben, der die Image-Instanz so festlegt, dass der Datenstrom verwendet wird. Dies kann nicht allein in XAML erfolgen. Erstellen Sie das zu verwendende Bild, oder verweisen Sie auf eine vorhandene Image-Instanz (die möglicherweise im XAML-Markup, aber ohne Quelle definiert wurde). Verwenden Sie dann die asynchrone SetSourceAsync-Methode von BitmapImage , um die Bildinformationen aus einem Datenstrom zu definieren, und übergeben Sie den Datenstrom, der als streamSource-Parameter verwendet werden soll. Die Verwendung eines Datenstroms für eine Bildquelle ist relativ häufig. Wenn Ihre App beispielsweise einem Benutzer die Auswahl einer Bilddatei mithilfe eines FileOpenPicker-Steuerelements ermöglicht, kann das objekt, das sie für die vom Benutzer ausgewählte Datei darstellt, als Datenstrom geöffnet werden, stellt jedoch keinen URI-Verweis (Uniform Resource Identifier) auf die Datei bereit.

In diesem Beispiel ist der Code bereits wartend, da er wartet, dass der Benutzer auf die Auswahl einer Datei wartet und erst danach ausgeführt wird. Der zu verwendende Datenstrom stammt aus StorageFile.OpenAsync , nachdem eine StorageFile-Instanz von den asynchronen Auswahlaktionen zurückgegeben wird.

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; 
    } 
}

Tip

Wenn Sie C# verwenden, können Datenströme den Typ System.IO.Stream verwenden, mit dem Sie möglicherweise aus der vorherigen Microsoft .NET Programmiererfahrung vertraut sind. Sie können die AsStream Erweiterungsmethode als Instanzmethode für jedes Objekt vom Typ IRandomAccessStream aufrufen, das Sie aus einer Windows Runtime-API abgerufen haben. Im vorherigen Beispiel wurde "IRandomAccessStream " zum Übergeben von Parametern verwendet und musste asStream nicht verwendet werden. Wenn Sie den Datenstrom jedoch jemals bearbeiten müssen, ist AsStream als Hilfsprogramm zum Konvertieren in ein System.IO.Stream vorhanden, wenn Sie ihn benötigen.

Weitere Beispielcode finden Sie unter 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 jedoch in einem UI-Bereich 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 kleineren Speicherbedarf 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 derselbe Wert wie die Breite oder ActualWidth des Bildsteuerelements sein, 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, sie sollten jedoch 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.

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

<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, der für die Source-Eigenschaft bereitgestellt werden soll. 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 mehrmals decodiert werden, weisen Sie der URI (Uniform Resource Identifier) bildquelleneigenschaft zu, anstatt Speicherströme zu verwenden, wenn Möglich. Das XAML-Framework kann denselben URI (Uniform Resource Identifier) an mehreren Stellen einem decodierten Bild zuordnen, aber es kann nicht für mehrere Speicherstreams identisch sein, auch wenn sie dieselben Daten enthalten.

Sie können Bilddateien aus dem Bildcache 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.

Bilddateicodierung und -decodierung

Die zugrunde liegende Codec-Unterstützung für Bilddateien wird von Windows Imaging Component (WIC)-API 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 der Decodierungsoptionen und -logik als Teil von Ereignisdaten für ImageOpened - oder ImageFailed-Ereignisse verfügbar. Wenn Sie erweiterte Bilddateidecodierung oder Bildcodierung benötigen, sollten Sie die API aus dem Windows verwenden. Graphics.Imaging Namespace. Möglicherweise benötigen Sie diese API, wenn Ihr App-Szenario Konvertierungen des Bilddateiformats oder die Manipulation eines Bilds umfasst, in dem der Benutzer das Ergebnis als Datei speichern kann. Die Codierungs-API wird auch von der Windows Imaging Component (WIC)-Komponente 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 Breiteoder 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 Maße für die Breite und Höhe verwendet, wenn das Bildsteuerelement 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 unmittelbar vor dem Rendern des Bilds überprüfen.

Wenn Sie nur eine der Eigenschaften "Width" oder "Height " festlegen, aber nicht beides, kann das System diese Dimension als Anleitung verwenden und das andere formatieren und dabei das Seitenverhältnis beibehalten. Wenn Sie sich nicht sicher sind, welche Quelldateiabmessungen sie haben, wählen Sie die Dimension aus, die für die Steuerung in Ihrem Layoutszenario am wichtigsten ist, und lassen Sie das System die andere Dimension berechnen, und das Layoutverhalten des Containers passt normalerweise das Layout an.

Wenn Sie " Breite und/oder Höhe" nicht festlegen und das Bild als natürliche Größe beibehalten, kann die Stretch-Eigenschaft für das Bild steuern, wie die Bildquelldatei den Abstand ausfüllt, den Sie als Breite und Höhe angeben. Der Standardwert "Stretch " ist "Uniform", wodurch das Seitenverhältnis beibehalten wird, wenn es in einen Layoutcontainer passt. Wenn die Abmessungen des Containers nicht über dasselbe Seitenverhältnis verfügen, gibt es leerer Platz, der noch Teil des Images ist, aber keine Bildpixel anzeigt, zumindest während der Verwendung des Uniform-Werts für Stretch. UniformToFill für Stretch bleibt nicht leer, sondern kann das Bild beschneiden, wenn die Abmessungen unterschiedlich sind. Die Füllung für "Stretch " lässt keinen leeren Platz auf, kann aber das Seitenverhältnis ändern. Sie können mit diesen Werten experimentieren, um zu sehen, was für die Bildanzeige in Ihrem Layoutszenario am besten geeignet ist. Beachten Sie außerdem, dass bestimmte Layoutcontainer ein Bild mit keiner bestimmten Breite und Höhe anpassen können, um den gesamten Layoutbereich auszufüllen. In diesem Fall können Sie festlegen, dass bestimmte Größen für das Bild oder den Container dafür festgelegt werden sollen.

NineGrid

Die Verwendung der NineGrid-Technik ist eine weitere Option zum Skalieren von Bildern mit einer anderen natürlichen Größe als der Anzeigebereich, wenn das Bild Bereiche aufweist, die nicht einheitlich skaliert werden sollen. Sie können z. B. ein Hintergrundbild verwenden, das einen inhärenten Rahmen aufweist, der nur in einer Dimension gestreckt werden soll, und Ecken, die überhaupt nicht gestreckt werden sollen, aber die Bildmitte kann gestreckt werden, um die Layoutanforderungen in beiden Dimensionen anzupassen. Weitere Informationen finden Sie unter NineGrid.

Ressourcenqualifizierung und Lokalisierung für Bild

Bildquelldateien und Skalierung

Sie sollten Ihre Bildquellen mit mehreren empfohlenen Größen erstellen, um sicherzustellen, dass Ihre App gut aussieht, wenn Windows sie skaliert. Wenn Sie eine Quelle für ein Bild 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 zur Laufzeit automatisch bestimmt. Einzelheiten zu den zu verwendenden Benennungskonventionen und weitere Informationen finden Sie in der Schnellstartanleitung: Verwenden von Datei- oder Bildressourcen.

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

Verwenden nicht qualifizierter Ressourcen

Nicht qualifizierte Ressourcen sind eine Technik, die Sie verwenden können, wenn sich der grundlegende Ressourcenverweis auf eine Standardressource bezieht, und der Ressourcenverwaltungsprozess kann die entsprechende lokalisierte Ressource automatisch finden. 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 Bild

Wenn Sie FlowDirection als RightToLeft für ein Bild 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 Verhalten beim Kippen von Bildern 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 Benutzergruppe von rechts nach links nicht sinnvoll sind. Zum Abrufen des Bild-Flip-Verhaltens müssen Sie das FlowDirection-Element für das Image-Element speziell auf RightToLeft festlegen oder die FlowDirection-Eigenschaft in CodeBehind festlegen. Erwägen Sie, das Image-Element durch x:Uid-Direktive 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.

Die Image-Klasse und Barrierefreiheit

Die Image-Klasse ist keine echte Steuerelementklasse, da es sich nicht um eine untergeordnete Klasse von Control handelt. Sie können den Fokus nicht auf ein Image-Element aufrufen oder ein Image-Element in einer Registerkartensequenz platzieren. Weitere Informationen zu den Barrierefreiheitsaspekten der Verwendung von Bildern und dem Image-Element in der Benutzeroberfläche finden Sie unter Grundlegende Informationen zur Barrierefreiheit.

Bildressourcen

Ressourcen können ein Ressourcenqualifizierermuster verwenden, um je nach gerätespezifischer Skalierung unterschiedliche 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 außerdem eines der Quellladeereignisse (ImageOpened oder ImageFailed) als Ergebnis der Aktion des Systems ausgelöst, die neue Ressource anzufordern und dann auf das Image anzuwenden. Das Szenario, in dem eine Änderung der Laufzeitskala auftreten kann, besteht darin, dass 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 in Fällen, in denen die Quelle in XAML festgelegt ist.

Konstruktoren

Name Beschreibung
Image()

Initialisiert eine neue Instanz der Image-Klasse .

Eigenschaften

Name Beschreibung
AccessKey

Dient zum Abrufen oder Festlegen der Zugriffstaste (Mnemonic) für dieses Element.

(Geerbt von UIElement)
AccessKeyScopeOwner

Dient zum Abrufen oder Festlegen eines Quellelements, das den Zugriffstastenbereich für dieses Element bereitstellt, auch wenn es sich nicht in der visuellen Struktur des Quellelements befindet.

(Geerbt von UIElement)
ActualHeight

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

(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 Anordnungsdurchlaufs des Layoutprozesses berechnet wurde.

(Geerbt von UIElement)
ActualTheme

Ruft das Ui-Design ab, das derzeit vom Element verwendet wird, was möglicherweise anders als das RequestedTheme sein kann.

(Geerbt von FrameworkElement)
ActualWidth

Ruft die gerenderte Breite eines FrameworkElements ab. Siehe Anmerkungen.

(Geerbt von FrameworkElement)
AllowDrop

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob dieses UIElement ein Drop-Ziel für Drag-and-Drop-Vorgänge sein kann.

(Geerbt von UIElement)
AllowFocusOnInteraction

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer damit interagiert.

(Geerbt von FrameworkElement)
AllowFocusWhenDisabled

Ruft ab oder legt fest, ob ein deaktiviertes Steuerelement den Fokus empfangen 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 nützlich für die URI-Auflösung zur Laufzeit.

(Geerbt von FrameworkElement)
CacheMode

Dient zum Abrufen oder Festlegen eines Werts, der angibt, dass gerenderter Inhalt nach Möglichkeit als zusammengesetzte Bitmap zwischengespeichert werden soll.

(Geerbt von UIElement)
CanBeScrollAnchor

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das UIElement ein Kandidat für die Bildlaufankerung sein kann.

(Geerbt von UIElement)
CanDrag

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Element in einem Drag-and-Drop-Vorgang als Daten gezogen werden kann.

(Geerbt von UIElement)
CenterPoint

Dient zum Abrufen oder Festlegen des Mittelpunkts des Elements, bei dem es sich um den Punkt handelt, an dem die Drehung oder Skalierung erfolgt. Wirkt sich auf die Renderingposition des Elements aus.

(Geerbt von UIElement)
Clip

Dient zum Abrufen oder Festlegen der RectangleGeometry-Eigenschaft , die zum Definieren der Gliederung des Inhalts eines UIElements verwendet wird.

(Geerbt von UIElement)
CompositeMode

Dient zum Abrufen oder Festlegen einer Eigenschaft, die alternative Kompositions- und Blendungsmodi für das Element im übergeordneten Layout und Fenster deklariert. Dies ist für Elemente relevant, die an einem gemischten XAML/Microsoft DirectX-UI beteiligt sind.

(Geerbt von UIElement)
ContextFlyout

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

(Geerbt von UIElement)
DataContext

Dient zum Abrufen oder Festlegen des Datenkontexts für ein FrameworkElement. Eine häufige Verwendung eines Datenkontexts ist die FrameworkElement Verwendung der {Binding} -Markuperweiterung und die Teilnahme an der Datenbindung.

(Geerbt von FrameworkElement)
DesiredSize

Ruft die Größe ab, die dieses UIElement während des Messdurchlaufs 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 ab DispatcherQueue , dem dieses Objekt zugeordnet ist. Dies DispatcherQueue stellt eine Einrichtung dar, die auf den DependencyObject UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird.

(Geerbt von DependencyObject)
ExitDisplayModeOnAccessKeyInvoked

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Zugriffstastenanzeige geschlossen wird, wenn eine Zugriffstaste aufgerufen wird.

(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 entweder LeftToRight oder RightToLeftauf . Wird FlowDirection auf RightToLeft ein beliebiges Element festgelegt, wird die Ausrichtung nach rechts, die Lesereihenfolge von rechts nach links und das Layout des Steuerelements festgelegt, das von rechts nach links fließt.

(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

Dient zum Abrufen oder Festlegen des äußeren Rands des visuellen Fokus für ein FrameworkElement.

(Geerbt von FrameworkElement)
FocusVisualPrimaryBrush

Dient zum Abrufen oder Festlegen des Pinsels, der zum Zeichnen des äußeren Rahmens eines HighVisibility visuellen Oder Reveal Fokus für ein FrameworkElement verwendet wird.

(Geerbt von FrameworkElement)
FocusVisualPrimaryThickness

Dient zum Abrufen oder Festlegen der Stärke des äußeren Rahmens eines HighVisibility visuellen Fokus Reveal für ein FrameworkElement.

(Geerbt von FrameworkElement)
FocusVisualSecondaryBrush

Dient zum Abrufen oder Festlegen des Pinsels, der zum Zeichnen des inneren Rahmens eines HighVisibility visuellen Fokus Reveal für ein FrameworkElement verwendet wird.

(Geerbt von FrameworkElement)
FocusVisualSecondaryThickness

Dient zum Abrufen oder Festlegen der Stärke des inneren Rahmens eines HighVisibility oder Reveal eines Fokusvisuals für ein FrameworkElement.

(Geerbt von FrameworkElement)
Height

Dient zum Abrufen oder Festlegen der vorgeschlagenen Höhe eines FrameworkElements.

(Geerbt von FrameworkElement)
HighContrastAdjustment

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Framework die visuellen Eigenschaften des Elements automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind.

(Geerbt von UIElement)
HorizontalAlignment

Ruft die horizontalen Ausrichtungsmerkmale ab, die auf ein FrameworkElement angewendet werden, wenn es in einem übergeordneten Layout erstellt wird, z. B. einem Panel- oder Elementsteuerelement.

(Geerbt von FrameworkElement)
IsAccessKeyScope

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Element seinen eigenen Zugriffstastenbereich definiert.

(Geerbt von UIElement)
IsDoubleTapEnabled

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das DoubleTapped-Ereignis aus diesem Element stammen kann.

(Geerbt von UIElement)
IsHitTestVisible

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

(Geerbt von UIElement)
IsHoldingEnabled

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das Holding-Ereignis aus diesem Element stammen kann.

(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

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das RightTapped-Ereignis aus diesem Element stammen kann.

(Geerbt von UIElement)
IsTabStop

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Steuerelement in der Registerkartennavigation enthalten ist.

(Geerbt von UIElement)
IsTapEnabled

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das Tapped-Ereignis aus diesem Element stammen kann.

(Geerbt von UIElement)
KeyboardAcceleratorPlacementMode

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die QuickInfo des Steuerelements die Tastenkombination für die zugehörige Zugriffstaste anzeigt.

(Geerbt von UIElement)
KeyboardAcceleratorPlacementTarget

Dient zum Abrufen oder Festlegen eines Werts, der die QuickInfo des Steuerelements angibt, die die Tastenkombination für die Tastenkombination anzeigt.

(Geerbt von UIElement)
KeyboardAccelerators

Ruft die Auflistung von Tastenkombinationen ab, die eine Aktion mithilfe der Tastatur aufrufen.

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

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

(Geerbt von UIElement)
KeyTipHorizontalOffset

Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie weit links oder rechts die Zugriffstasteninfo im Verhältnis zum UIElement platziert wird.

(Geerbt von UIElement)
KeyTipPlacementMode

Dient zum Abrufen oder Festlegen eines Werts, der angibt, wo die Zugriffstastentasteninfo in Bezug auf die Grenze des UIElement platziert wird.

(Geerbt von UIElement)
KeyTipTarget

Dient zum Abrufen oder Festlegen eines Werts, der das Element angibt, das von der Zugriffstastentasteninfo bestimmt wird.

(Geerbt von UIElement)
KeyTipVerticalOffset

Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie weit nach oben oder unten die Zugriffstasteninfo im Verhältnis zum UI-Element platziert wird.

(Geerbt von UIElement)
Language

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

(Geerbt von FrameworkElement)
Lights

Ruft die Auflistung von XamlLight-Objekten ab, die diesem Element zugeordnet sind.

(Geerbt von UIElement)
ManipulationMode

Dient zum Abrufen oder Festlegen des ManipulationModes-Werts , der für uiElement-Verhalten und Interaktion mit Gesten verwendet wird. Das Festlegen dieses Werts ermöglicht das Behandeln der Manipulationsereignisse aus diesem Element im App-Code.

(Geerbt von UIElement)
Margin

Dient zum Abrufen oder Festlegen des äußeren Rands eines FrameworkElements.

(Geerbt von FrameworkElement)
MaxHeight

Dient zum Abrufen oder Festlegen der maximalen Höheneinschränkung eines FrameworkElements.

(Geerbt von FrameworkElement)
MaxWidth

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

(Geerbt von FrameworkElement)
MinHeight

Dient zum Abrufen oder Festlegen der Minimalhöheneinschränkung eines FrameworkElements.

(Geerbt von FrameworkElement)
MinWidth

Dient zum Abrufen oder Festlegen der Minimalbreiteneinschränkung eines FrameworkElements.

(Geerbt von FrameworkElement)
Name

Dient zum Abrufen oder Festlegen des identifizierenden Namens des Objekts. Wenn ein XAML-Prozessor die Objektstruktur aus XAML-Markup erstellt, kann Laufzeitcode anhand dieses Namens auf das xaml-deklarierte Objekt verweisen.

(Geerbt von FrameworkElement)
NineGrid

Dient zum Abrufen oder Festlegen eines Werts für eine Neun-Raster-Metapher, die steuert, wie die Größe des Bilds geändert werden kann. Mit der Neunrastermetapher können Sie Ränder und Ecken eines Bilds anders als seine Mitte strecken. Weitere Informationen und eine Abbildung finden Sie in den Hinweisen.

NineGridProperty

Identifies the NineGrid dependency property.

Opacity

Dient zum Abrufen oder Festlegen des Grads der Deckkraft des Objekts.

(Geerbt von UIElement)
OpacityTransition

Dient zum Abrufen oder Festlegen der SkalarTransition, die Änderungen an der Opacity -Eigenschaft animiert.

(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, dargestellt als Zeigerwerte .

(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

Dient zum Abrufen oder Festlegen des Cursors, der angezeigt wird, wenn der Zeiger über diesem Element liegt. Der Standardwert ist NULL, der keine Änderung des Cursors angibt.

(Geerbt von UIElement)
RasterizationScale

Ruft einen Wert ab, der einen zusätzlichen Skalierungsfaktor darstellt, der beim Rendern von Formen, Bildern, Text oder Medien verwendet werden soll, normalerweise um eine höhere Auflösung als normal zu rendern.

(Geerbt von UIElement)
RenderSize

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

(Geerbt von UIElement)
RenderTransform

Dient zum Abrufen oder Festlegen von Transformationsinformationen, die sich auf die Renderingposition eines UIElements auswirken.

(Geerbt von UIElement)
RenderTransformOrigin

Ruft den Ursprungspunkt einer möglichen Rendertransformation ab, die von RenderTransform deklariert wird, relativ zu den Grenzen des UIElements.

(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 von Ihnen angegebene RequestedTheme Ui-Design 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-Sammlungssyntax einrichten.

(Geerbt von FrameworkElement)
Rotation

Ruft den Winkel der Drehung im Uhrzeigersinn in Grad ab oder legt den Winkel 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

Dient zum Abrufen oder Festlegen der ScalarTransition, die Änderungen an der Rotation -Eigenschaft animiert.

(Geerbt von UIElement)
Scale

Dient zum Abrufen oder Festlegen der Skalierung des Elements. Skaliert relativ zum CenterPoint des Elements. Wirkt sich auf die Renderingposition des Elements aus.

(Geerbt von UIElement)
ScaleTransition

Dient zum Abrufen oder Festlegen der Vector3Transition, die Änderungen an der Scale -Eigenschaft animiert.

(Geerbt von UIElement)
Shadow

Dient zum Abrufen oder Festlegen des Schatteneffekts, der vom Element gegossen wird.

(Geerbt von UIElement)
Source

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

SourceProperty

Identifies the Source dependency property.

Stretch

Dient zum Abrufen oder Festlegen eines Werts, der beschreibt, wie ein Bild gestreckt werden soll, um das Zielrechteck auszufüllen.

StretchProperty

Identifies the Stretch dependency property.

Style

Dient zum Abrufen oder Festlegen einer Instanzformatvorlage , die während des Layouts und Renderns für dieses Objekt angewendet wird.

(Geerbt von FrameworkElement)
TabFocusNavigation

Dient zum Abrufen oder Festlegen eines Werts, der die Funktionsweise von Tabbing und TabIndex für dieses Steuerelement ändert.

(Geerbt von UIElement)
TabIndex

Dient zum Abrufen oder Festlegen eines Werts, der die Reihenfolge bestimmt, in der Elemente den Fokus erhalten, wenn der Benutzer mithilfe der TAB-TASTE durch Steuerelemente navigiert.

(Geerbt von UIElement)
Tag

Dient zum Abrufen oder Festlegen eines beliebigen Objektwerts, der zum Speichern von benutzerdefinierten Informationen zu diesem Objekt verwendet werden kann.

(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

Dient zum Abrufen oder Festlegen der Transformationsmatrix, die auf das Element angewendet werden soll.

(Geerbt von UIElement)
Transitions

Dient zum Abrufen oder Festlegen der Auflistung von Übergangsstilelementen , die auf ein UIElement angewendet werden.

(Geerbt von UIElement)
Translation

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

(Geerbt von UIElement)
TranslationTransition

Dient zum Abrufen oder Festlegen der Vector3Transition, die Änderungen an der Translation -Eigenschaft animiert.

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

(Geerbt von FrameworkElement)
UseLayoutRounding

Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das Rendern für das Objekt und dessen visuelle Unterstruktur ein Rundungsverhalten verwenden soll, das das Rendern auf ganze Pixel ausgerichtet.

(Geerbt von UIElement)
UseSystemFocusVisuals

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Fokusvisuale verwendet, die vom System oder von fokus visuellen Elementen gezeichnet werden, die in der Steuerelementvorlage definiert sind.

(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

Dient zum Abrufen oder Festlegen der Sichtbarkeit eines UIElements. Ein UIElement nicht sichtbarer Wert wird nicht gerendert und kommuniziert nicht seine gewünschte Größe mit dem Layout.

(Geerbt von UIElement)
Width

Dient zum Abrufen oder Festlegen der Breite eines FrameworkElements.

(Geerbt von FrameworkElement)
XamlRoot

Dient zum Abrufen oder Festlegen des XamlRoot Elements, in dem dieses Element angezeigt wird.

(Geerbt von UIElement)
XYFocusDown

Ruft ab oder legt das Objekt fest, das den Fokus erhält, wenn ein Benutzer auf dem Directional Pad (D-Pad) eines Gamecontrollers nach unten drückt.

(Geerbt von UIElement)
XYFocusDownNavigationStrategy

Dient zum Abrufen oder Festlegen eines Werts, der die Strategie angibt, mit der das Zielelement einer Abwärtsnavigation bestimmt wird.

(Geerbt von UIElement)
XYFocusKeyboardNavigation

Dient zum Abrufen oder Festlegen eines Werts, der die Navigation mithilfe der Tastaturrichtungspfeile aktiviert oder deaktiviert.

(Geerbt von UIElement)
XYFocusLeft

Ruft ab oder legt das Objekt fest, das den Fokus erhält, wenn ein Benutzer auf dem Directional Pad (D-Pad) eines Gamecontrollers nach links drückt.

(Geerbt von UIElement)
XYFocusLeftNavigationStrategy

Dient zum Abrufen oder Festlegen eines Werts, der die Strategie angibt, mit der das Zielelement einer linken Navigation bestimmt wird.

(Geerbt von UIElement)
XYFocusRight

Ruft ab oder legt das Objekt fest, das den Fokus erhält, wenn ein Benutzer rechts auf das Directional Pad (D-Pad) eines Gamecontrollers drückt.

(Geerbt von UIElement)
XYFocusRightNavigationStrategy

Dient zum Abrufen oder Festlegen eines Werts, der die Strategie angibt, mit der das Zielelement einer rechten Navigation bestimmt wird.

(Geerbt von UIElement)
XYFocusUp

Ruft ab oder legt das Objekt fest, das den Fokus erhält, wenn ein Benutzer auf das Directional Pad (D-Pad) eines Gamecontrollers drückt.

(Geerbt von UIElement)
XYFocusUpNavigationStrategy

Dient zum Abrufen oder Festlegen eines Werts, der die Strategie angibt, mit der das Zielelement einer up-Navigation bestimmt wird.

(Geerbt von UIElement)

Methoden

Name Beschreibung
AddHandler(RoutedEvent, Object, Boolean)

Fügt einen Routingereignishandler für ein angegebenes Routingereignis hinzu, und fügt den Handler der Handlerauflistung für das aktuelle Element hinzu. Geben Sie an handledEventsToo , dass true 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 direkte Manipulationsverarbeitung (systemdefiniertes Schwenken/Zoomen) auf jedem übergeordneten ScrollViewer-Element ab, das das aktuelle UIElement enthält.

(Geerbt von UIElement)
CapturePointer(Pointer)

Legt die Zeigererfassung auf ein UIElement fest. Nach der Erfassung löst nur das Element, das erfasst wurde, Zeigerereignisse aus.

(Geerbt von UIElement)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Abhängigkeitseigenschaft.

(Geerbt von DependencyObject)
FindName(String)

Ruft ein Objekt ab, das den angegebenen Bezeichnernamen aufweist.

(Geerbt von FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

Aktiviert eine UIElement-Unterklasse , um untergeordnete Elemente verfügbar zu machen, die bei der Auflösung 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 Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, was in Fällen angewendet wird, in denen eine Animation nicht aktiv ist.

(Geerbt von DependencyObject)
GetAsCastingSource()

Gibt das Bild als CastingSource zurück.

GetBindingExpression(DependencyProperty)

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

(Geerbt von FrameworkElement)
GetChildrenInTabFocusOrder()

Aktiviert eine UIElement-Unterklasse , um untergeordnete Elemente verfügbar zu machen, die am Tabstoppfokus teilnehmen.

(Geerbt von UIElement)
GetValue(DependencyProperty)

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

(Geerbt von DependencyObject)
GetVisualInternal()

Ruft das Visual Element ab, in das das Element aufgelöst wird.

(Geerbt von UIElement)
GoToElementStateCore(String, Boolean)

Wenn sie in einer abgeleiteten Klasse implementiert wird, wird die Erstellung einer visuellen Struktur 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ültiger Anordnungszustand (Layout) für ein UIElement. Nach der Ungültigheit wird das UIElement das Layout aktualisiert, das asynchron auftritt.

(Geerbt von UIElement)
InvalidateMeasure()

Ungültiger Maßzustand (Layout) für ein UIElement.

(Geerbt von UIElement)
InvalidateViewport()

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

(Geerbt von FrameworkElement)
Measure(Size)

Aktualisiert die 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 eine rekursive Layoutaktualisierung zu bilden.

(Geerbt von UIElement)
MeasureOverride(Size)

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

(Geerbt von FrameworkElement)
OnApplyTemplate()

Wird aufgerufen, wenn Anwendungscode oder interne Prozesse (z. B. ein neuerstellender Layoutdurchlauf) ApplyTemplate aufrufen. Dies bedeutet, dass die Methode einfach 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()

Wenn sie in einer abgeleiteten Klasse implementiert wird, werden klassenspezifische AutomationPeerimplementierungen für die Microsoft UI Automation Infrastruktur zurückgegeben.

(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 Zugriffstaste) in Ihrer App verarbeitet wird. Überschreiben Sie diese Methode, um zu behandeln, wie Ihre App reagiert, wenn eine Zugriffstaste aufgerufen wird.

(Geerbt von UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

Wird direkt aufgerufen, bevor eine Tastenkombination (oder Zugriffstaste) in Ihrer App verarbeitet wird. Wird immer aufgerufen, wenn Anwendungscode oder interne Prozesse ProcessKeyboardAccelerators aufrufen. Überschreiben Sie diese Methode, um die Standardmäßige Zugriffstastenbehandlung zu beeinflussen.

(Geerbt von UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)

Definiert eine Eigenschaft, die animiert werden kann.

(Geerbt von UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

Wenn eine abgeleitete Klasse überschrieben wird, wird eine Eigenschaft definiert, die animiert werden kann.

(Geerbt von UIElement)
ReadLocalValue(DependencyProperty)

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

(Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Registriert eine Benachrichtigungsfunktion, um Änderungen an einer bestimmten DependencyProperty für diese DependencyObject-Instanz zu überwachen.

(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 fragliche Handler von AddHandler hinzugefügt.

(Geerbt von UIElement)
SetBinding(DependencyProperty, BindingBase)

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

(Geerbt von FrameworkElement)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest.

(Geerbt von DependencyObject)
StartAnimation(ICompositionAnimationBase)

Beginnt die angegebene Animation für das Element.

(Geerbt von UIElement)
StartBringIntoView()

Initiiert eine Anforderung an das XAML-Framework, um das Element in alle bildlauffähigen Bereiche 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 in die Ansicht zu bringen.

(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 Datenstrom festgelegt werden. Die Liste der unterstützten Bildquellenformate finden Sie in den Hinweisen.

(Geerbt von UIElement)
StartDragAsync(PointerPoint)

Initiiert einen Drag-and-Drop-Vorgang.

Important

Wird nicht unterstützt, wenn ein Benutzer die App im Modus mit erhöhten Rechten ausführt, als Administrator.

(Geerbt von UIElement)
StopAnimation(ICompositionAnimationBase)

Beendet die angegebene Animation für das Element.

(Geerbt von UIElement)
TransformToVisual(UIElement)

Gibt ein Transformationsobjekt zurück, das zum Transformieren von Koordinaten vom UIElement in das angegebene Objekt verwendet werden kann.

(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 für das Layout ordnungsgemäß aktualisiert werden.

(Geerbt von UIElement)

Ereignisse

Name Beschreibung
AccessKeyDisplayDismissed

Tritt auf, wenn Zugriffstasten nicht mehr angezeigt werden sollen.

(Geerbt von UIElement)
AccessKeyDisplayRequested

Tritt auf, wenn der Benutzer die Anzeige von Zugriffstasten anfordert.

(Geerbt von UIElement)
AccessKeyInvoked

Tritt auf, wenn ein Benutzer eine Zugriffstastenabfolge abgeschlossen hat.

(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 in eine Manipulationsgeste 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. mit der rechten Maustaste.

(Geerbt von UIElement)
DataContextChanged

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

(Geerbt von FrameworkElement)
DoubleTapped

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

(Geerbt von UIElement)
DragEnter

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

(Geerbt von UIElement)
DragLeave

Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drag-Ereignis 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 Drop-Ereignis mit diesem Element als Drop-Ziel meldet.

(Geerbt von UIElement)
DropCompleted

Tritt auf, wenn ein Drag-and-Drop-Vorgang mit diesem Element beendet wird, während die 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 bubblingt.

(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 die Bubbling abgeschlossen ist.

(Geerbt von UIElement)
Holding

Tritt auf, wenn eine andernfalls nicht behandelte Haltebereich über den Treffertestbereich dieses Elements erfolgt.

(Geerbt von UIElement)
ImageFailed

Tritt auf, wenn ein Fehler auftritt, der mit dem Abrufen oder Format von Bildern verknüpft ist.

ImageOpened

Tritt auf, wenn die Bildquelle heruntergeladen und ohne Fehler decodiert wird. Mit diesem Ereignis können Sie die natürliche Größe der Bildquelle ermitteln.

KeyDown

Tritt auf, wenn eine Tastatur 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, da 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 mit dem 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 bubblingt.

(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 die Bubbling abgeschlossen ist.

(Geerbt von UIElement)
ManipulationCompleted

Tritt auf, wenn eine Bearbeitung für das UIElement abgeschlossen ist.

(Geerbt von UIElement)
ManipulationDelta

Tritt auf, wenn das Eingabegerät die Position während einer Manipulation ändert.

(Geerbt von UIElement)
ManipulationInertiaStarting

Tritt auf, wenn das Eingabegerät den Kontakt mit dem UIElement -Objekt während einer Manipulation verliert und die Tia beginnt.

(Geerbt von UIElement)
ManipulationStarted

Tritt auf, wenn ein Eingabegerät mit einer Manipulation des UIElements beginnt.

(Geerbt von UIElement)
ManipulationStarting

Tritt auf, wenn der Bearbeitungsprozessor zum ersten Mal erstellt wird.

(Geerbt von UIElement)
NoFocusCandidateFound

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

(Geerbt von UIElement)
PointerCanceled

Tritt auf, wenn ein Zeiger, der Kontakt ungewöhnlich kontaktiert hat, den Kontakt verliert.

(Geerbt von UIElement)
PointerCaptureLost

Tritt auf, wenn der Zeiger, der zuvor von diesem Element gehalten wurde, in ein anderes Element oder an eine andere Stelle verschoben wird.

(Geerbt von UIElement)
PointerEntered

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

(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 im Treffertestbereich dieses Elements verbleibt.

(Geerbt von UIElement)
PointerPressed

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

(Geerbt von UIElement)
PointerReleased

Tritt auf, wenn das Zeigergerät, das zuvor eine Drücken-Aktion initiiert hat, freigegeben wird, während innerhalb dieses Elements. Beachten Sie, dass das Ende einer Presseaktion nicht garantiert ist, dass ein PointerReleased Ereignis ausgelöst wird. Andere Ereignisse können stattdessen ausgelöst werden. Weitere Informationen finden Sie in den Anmerkungen.

(Geerbt von UIElement)
PointerWheelChanged

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

(Geerbt von UIElement)
PreviewKeyDown

Tritt auf, wenn eine Tastatur 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 Zugriffstaste) 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 andernfalls nicht behandelte Tippinteraktion über dem 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