Image Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein 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, "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 : FrameworkElementPublic NotInheritable Class Image
Inherits FrameworkElement<Image .../>
- Vererbung
- Attribute
Beispiele
Tipp
Weitere Informationen, Entwurfsanleitungen und Codebeispiele finden Sie unter Bilder und Bildpinsel.
Die WinUI 3-Katalog-App umfasst interaktive Beispiele für die meisten WinUI 3-Steuerelemente, -Features und -Funktionen. Rufen Sie die App aus dem Microsoft Store oder den Quellcode auf GitHub ab.
Hinweise
Bilddateiformate
Ein 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)
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 für die meisten Szenarien müssen Sie nicht mit den asynchronen Aspekten des Ladens von Bildern interagieren. Das Framework wartet auf die Rückgabe der Bildquelle und startet einen Layoutzyklus, wenn die Bildquelldatei verfügbar und decodiert ist.
Das Festlegen der Quelle auf einen URI-Wert (Uniform Resource Identifier), der nicht in eine gültige Bildquelldatei aufgelöst werden kann, löst keine Ausnahme aus. Stattdessen wird ein ImageFailed-Ereignis ausgelöst . Sie können einen ImageFailed-Handler schreiben und an das Image-Objekt anfügen, und möglicherweise die ErrorMessage in Ereignisdaten verwenden, um die Art des Fehlers zu bestimmen. Ein Fehler bei der Decodierung kann auch ImageFailed auslösen. Wenn Sie überprüfen möchten, ob eine Bildquelldatei ordnungsgemäß geladen wurde, können Sie das ImageOpened-Ereignis für das Image-Element behandeln.
In der Regel verwenden Sie Bildquelldateien, die Sie als Teil Ihres App-Downloadpakets eingeschlossen haben. Bei großen Dateien kann es zu einer sehr geringen Verzögerung kommen, während die Bildquelldatei decodiert wird, wenn dies das erste Mal ist, dass die Quelle verwendet wird. Weitere Informationen zu App-Ressourcen und zum Verpacken von Bildquelldateien in einem App-Paket finden Sie unter Definieren von App-Ressourcen.
Sie können auch Bildquelldateien verwenden, die nicht Teil der App sind, z. B. Bilder von externen Servern. Diese Images werden von einer internen HTTP-Anforderung heruntergeladen und dann decodiert. Wenn die Bildquelldatei eine große Datei ist oder Verbindungsprobleme auftreten, kann es zu einer Verzögerung kommen, bevor ein externes Bild in einem Image-Element angezeigt werden kann.
Festlegen von Image.Source mithilfe von Code
Wenn Sie ein Image-Objekt mithilfe von Code erstellen, rufen Sie den Standardkonstruktor auf, und legen Sie dann die Image.Source-Eigenschaft fest. 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 Uniform Resource Identifier (URI) einschließen, den Sie als BitmapImage-Konstruktorparameter verwenden. Im Code erhalten Sie nicht die Verarbeitungsverknüpfungen für die Kombination relativer URI-Teile (Uniform Resource Identifier) und des Schemas ms-appx: , das automatisch erfolgt, wenn Sie Source als XAML-Attribut angeben. Stattdessen müssen Sie explizit einen absoluten URI (Uniform Resource Identifier) mit dem entsprechenden Schema erstellen. Sie verwenden in der Regel das Schema ms-appx: für eine Bilddatei, die als Teil Ihrer App gepackt wird.
Tipp
Wenn Sie C# oder Microsoft Visual Basic verwenden, können Sie die BaseUri-Eigenschaft des Image abrufen und diese 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 Imagequelle
Wenn es sich bei Ihrer Bildquelle um einen Stream handelt, müssen Sie Code schreiben, der festlegt, dass Ihr Image-instance den Stream verwenden kann. 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, jedoch ohne Quelle). Verwenden Sie dann die asynchrone SetSourceAsync-Methode von BitmapImage , um die Bildinformationen aus einem Stream zu definieren, und übergeben Sie den Stream, der als streamSource-Parameter verwendet werden soll. Die Verwendung eines Datenstroms für eine Bildquelle ist ziemlich häufig. Wenn Ihre App es beispielsweise einem Benutzer ermöglicht, eine Bilddatei mithilfe eines FileOpenPicker-Steuerelements auszuwählen, kann das Objekt, das sie erhalten, das die vom Benutzer ausgewählte Datei darstellt, als Stream geöffnet werden, aber keinen URI (Uniform Resource Identifier) verweis auf die Datei.
In diesem Beispiel ist der Code bereits abwartbar, da er darauf wartet, dass der Benutzer eine Datei auswählt und erst danach ausgeführt wird. Der zu verwendende Stream stammt von StorageFile.OpenAsync, nachdem 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 Typ System.IO.Stream verwenden, mit dem Sie möglicherweise aus früheren Microsoft .NET-Programmiererfahrungen vertraut sind. Sie können die AsStream-Erweiterungsmethode als instance-Methode für jedes Objekt vom Typ 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 ein Hilfsprogramm, um bei Bedarf in eine System.IO.Stream zu konvertieren.
Weitere Beispielcode finden Sie im Beispiel für XAML-Bilder .
Bilddateien und Leistung
Große Bilddateien können die Leistung beeinträchtigen, da sie in den Arbeitsspeicher geladen werden. Wenn Sie auf eine Bilddatei verweisen, in der Sie wissen, dass es sich bei der Quelldatei um ein großes, hochauflösendes Bild handelt, ihre App es jedoch in einer Benutzeroberflächenregion anzeigt, die kleiner als die natürliche Größe des Bilds ist, sollten Sie die DecodePixelWidth-Eigenschaft oder DecodePixelHeight festlegen. Mit den DecodePixel*-Eigenschaften können Sie Informationen direkt an den formatspezifischen Codec übergeben, und der Codec kann diese Informationen verwenden, um effizienter und auf einen geringeren Arbeitsspeicherbedarf zu decodieren. Legen Sie DecodePixelWidth auf die gleiche Pixelbreite des Bereichs fest, den Ihre App tatsächlich anzeigen soll. Mit anderen Worten: DecodePixelWidth für die BitmapImage-Quelle sollte den gleichen Wert wie die Width oder ActualWidth des Image-Steuerelements haben, das diese Quelle anzeigt.
Sie können decodePixelWidth oder DecodePixelHeight festlegen. Wenn Sie eine dieser beiden Eigenschaften festlegen, berechnet das System die übereinstimmende Eigenschaft, um das richtige Seitenverhältnis beizubehalten. Sie können auch beide Eigenschaften festlegen, aber Sie sollten in der Regel Werte verwenden, die dieses Seitenverhältnis beibehalten. Wenn Sie Seitenverhältnisse ändern möchten, gibt es bessere Möglichkeiten, dies zu tun, z. B. die Verwendung einer TranslateTransform als RenderTransform.
Um DecodePixelWidth (oder DecodePixelHeight) in XAML festzulegen, müssen Sie eine etwas ausführlichere XAML-Syntax verwenden, die ein explizites BitmapImage-Element als Eigenschaftselementwert wie folgt enthält:
<Image>
<Image.Source>
<BitmapImage DecodePixelWidth="200" UriSource="images/myimage.png"/>
</Image.Source>
</Image>
DecodePixelWidth (oder DecodePixelHeight) sind Eigenschaften von BitmapImage. Daher benötigen Sie ein explizites BitmapImage-XAML-Objektelement, um die DecodePixel*-Eigenschaften als Attribute in XAML festzulegen.
Wenn Sie ein Image-instance im Code erstellen, erstellen Sie wahrscheinlich bereits eine BitmapImage-instance als Wert, der für die Source-Eigenschaft bereitgestellt werden soll. Legen Sie daher einfach DecodePixelWidth (oder DecodePixelHeight) auf dem 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 Bildquelleigenschaft von Uniform Resource Identifier (URI) zu, anstatt Speicherdatenströme zu verwenden, wann immer möglich. Das XAML-Framework kann denselben Uniform Resource Identifier (URI) an mehreren Stellen einem decodierten Bild zuordnen, aber es kann dies nicht für mehrere Speicherdatenströme tun, auch wenn sie dieselben Daten enthalten.
Sie können Bilddateien aus dem Imagecache entfernen, indem Sie alle zugeordneten Image.Source-Werte auf NULL festlegen.
Weitere Informationen zur Image-Klasse und -Leistung finden Sie unter Optimieren von Animationen und Medien.
Codierung und Decodierung von Bilddateien
Die zugrunde liegende Codecunterstützung für Bilddateien wird von der WIC-API (Windows Imaging Component) bereitgestellt. Weitere Informationen zu bestimmten Bildformaten, die für die Codecs dokumentiert sind, finden Sie unter Native WIC-Codecs.
Die API für Image, BitmapImage und BitmapSource enthält keine dedizierten Methoden zum Codieren und Decodieren von Medienformaten. Alle Decodierungsvorgänge sind als Aktionen integriert, die auftreten, wenn die Quelle festgelegt oder zurückgesetzt wird. Dies macht die Verwendung der Klassen zum Erstellen der Benutzeroberfläche einfacher, da sie über einen Standardsatz von unterstützten Quelldateiformaten und Decodierungsverhalten verfügen. Klassen wie BitmapImage machen einige decodierungsoptionen und logik als Teil von Ereignisdaten für ImageOpened - oder ImageFailed-Ereignisse verfügbar . Wenn Sie eine erweiterte Bilddateidecodierung oder Bildcodierung benötigen, sollten Sie die API aus dem Windows.Graphics.Imaging-Namespace verwenden. Möglicherweise benötigen Sie diese API, wenn Ihr App-Szenario Konvertierungen von Bilddateiformaten oder die Bearbeitung eines Bilds umfasst, bei dem der Benutzer das Ergebnis als Datei speichern kann. Die Codierungs-API wird auch von der WiC-Komponente (Windows Imaging Component) von Windows unterstützt.
Bildbreite und -höhe
Die Image-Klasse erbt die Width - und Height-Eigenschaften von FrameworkElement, und diese Eigenschaften steuern möglicherweise die Größe, die ihr Image-Steuerelement rendert, wenn es auf der Benutzeroberfläche angezeigt wird. Wenn Sie keine Breite oder Höhe festlegen, wird die Breite und Höhe durch die natürliche Größe der Bildquelle bestimmt. Wenn Sie beispielsweise ein Bitmapbild laden, das 300 Pixel hoch und 400 Pixel breit ist, wie im Quelldateiformat aufgezeichnet, werden diese Messungen für die Breite und Höhe verwendet, wenn das Image-Steuerelement seine natürliche Größe berechnet. Sie können ActualHeight und ActualWidth zur Laufzeit überprüfen, nachdem das Bild gerendert wurde, um die Messinformationen abzurufen. Oder Sie können ImageOpened behandeln und Bilddateieigenschaften wie PixelHeight und PixelWidth direkt vor dem Rendern des Bilds überprüfen.
Wenn Sie nur eine der Eigenschaften Width oder Height festlegen, aber nicht beide, kann das System diese Dimension als Orientierungshilfe verwenden und die andere Dimension berechnen, wobei das Seitenverhältnis beibehalten wird. Wenn Sie sich mit den Quelldateidimensionen nicht sicher sind, wählen Sie die Dimension aus, die in Ihrem Layoutszenario am wichtigsten zu steuern ist, und lassen Sie das System die andere Dimension berechnen, und dann passt das Layoutverhalten des Containers in der Regel das Layout an.
Wenn Sie Breite und/oder Höhe nicht festlegen und das Bild als natürliche Größe belassen, kann die Stretch-Eigenschaft für das Bild steuern, wie die Bildquelldatei den als Breite und Höhe angegebenen Raum füllt. Der Standard-Stretch-Wert ist Uniform, wodurch das Seitenverhältnis beibehalten wird, wenn das Bild in einen Layoutcontainer eingefügt wird. Wenn die Dimensionen des Containers nicht das gleiche Seitenverhältnis aufweisen, gibt es einen leeren Bereich, der weiterhin Teil von Image ist, aber keine Bildpixel anzeigt, zumindest wenn der Uniform-Wert für Stretch verwendet wird. UniformToFill für Stretch lässt keinen leeren Platz, sondern kann das Bild ausschneiden, wenn sich die Dimensionen unterscheiden. Füllen für Stretch lässt keinen leeren Platz, sondern kann das Seitenverhältnis ändern. Sie können mit diesen Werten experimentieren, um zu ermitteln, was für die Bildanzeige in Ihrem Layoutszenario am besten geeignet ist. Beachten Sie außerdem, dass bestimmte Layoutcontainer möglicherweise ein Bild groß dimensionieren, das keine bestimmte Breite und Höhe aufweist, um den gesamten Layoutraum auszufüllen. In diesem Fall können Sie bestimmte Größen für das Image oder den Container festlegen.
NineGrid
Die Verwendung der NineGrid-Technik ist eine weitere Option zum Skalieren von Bildern, die eine andere natürliche Größe als Ihr Anzeigebereich haben, wenn das Bild Regionen aufweist, die nicht einheitlich skaliert werden sollten. Sie können beispielsweise ein Hintergrundbild mit einem inhärenten Rahmen verwenden, der sich nur in einer Dimension erstrecken sollte, und Ecken, die sich überhaupt nicht dehnen sollten, aber das Bildzentrum kann sich dehnen, um die Layoutanforderungen in beiden Dimensionen zu erfüllen. Weitere Informationen finden Sie unter NineGrid.
Ressourcenqualifizierung und Lokalisierung für Image
Bildquelldateien und Skalierung
Sie sollten Ihre Bildquellen in mehreren empfohlenen Größen erstellen, um sicherzustellen, dass Ihre App beim Skalieren Windows 8 gut aussieht. Wenn Sie eine Quelle für ein Image angeben, können Sie eine Benennungskonvention für Ressourcen verwenden, die die richtige Ressource für gerätespezifische Skalierungsfaktoren verwenden. Dies wird von der App automatisch zur Laufzeit bestimmt. Einzelheiten zu den zu verwendenden Benennungskonventionen und weitere Informationen finden Sie unter Schnellstart: Verwenden von Datei- oder Bildressourcen.
Weitere Informationen zum richtigen Entwerfen von Bildern für die Skalierung finden Sie unter UX-Richtlinien für Layout und Skalierung.
Verwenden nicht qualifizierter Ressourcen
Nicht qualifizierte Ressourcen sind eine Technik, die Sie verwenden können, wenn der grundlegende Ressourcenverweis auf eine Standardressource verweist, und der Ressourcenverwaltungsprozess die entsprechende lokalisierte Ressource automatisch finden kann. Sie können die automatische Verarbeitung für den Zugriff auf nicht qualifizierte Ressourcen mit aktuellen Skalierungs- und Kulturqualifizierern verwenden, oder Sie können ResourceManager und ResourceMap mit Qualifizierern für Kultur und Skalierung verwenden, um die Ressourcen direkt abzurufen. Weitere Informationen finden Sie unter Ressourcenverwaltungssystem.
FlowDirection für Bild
Wenn Sie FlowDirection für ein Bild auf RightToLeft festlegen, wird der visuelle Inhalt eines Bilds horizontal gedreht. 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.
Bildressourcen
Ressourcen können ein Ressourcenqualifizierermuster verwenden, um je nach gerätespezifischer Skalierung verschiedene Ressourcen zu laden. Jede Ressource, die ursprünglich für Ihre App abgerufen wurde, wird 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. Daher können ImageOpened - oder ImageFailed-Ereignisse zur Laufzeit auftreten, wenn die Skalierungsänderung behandelt wird, auch wenn die Quelle in XAML festgelegt ist.
Konstruktoren
| Image() |
Initialisiert eine neue instance der Image-Klasse. |
Eigenschaften
| AccessKey |
Ruft den Zugriffsschlüssel (mnemonisch) für dieses Element ab oder legt diesen fest. (Geerbt von UIElement) |
| AccessKeyScopeOwner |
Ruft ein Quellelement ab, das den Zugriffsschlüsselbereich für dieses Element bereitstellt, auch wenn es sich nicht in der visuellen Struktur des Quellelements befindet, oder legt es fest. (Geerbt von UIElement) |
| ActualHeight |
Ruft die gerenderte Höhe eines FrameworkElements ab. Siehe Hinweise. (Geerbt von FrameworkElement) |
| ActualOffset |
Ruft die Position dieses UIElements relativ zum übergeordneten Element ab, das während des Anordnens des Layoutprozesses berechnet wird. (Geerbt von UIElement) |
| ActualSize |
Ruft die Größe ab, die dieses UIElement während des Anordnens des Layoutprozesses berechnet hat. (Geerbt von UIElement) |
| ActualTheme |
Ruft das UI-Design ab, das derzeit vom -Element verwendet wird, das sich von der RequestedTheme unterscheiden kann. (Geerbt von FrameworkElement) |
| ActualWidth |
Ruft die gerenderte Breite eines FrameworkElements ab. Siehe Hinweise. (Geerbt von FrameworkElement) |
| AllowDrop |
Ruft einen Wert ab, der bestimmt, ob dieses UIElement ein Ablageziel für Drag-and-Drop-Vorgänge sein kann, oder legt ihn fest. (Geerbt von UIElement) |
| AllowFocusOnInteraction |
Ruft einen Wert ab, der angibt, ob das Element automatisch den Fokus erhält, wenn der Benutzer mit dem Element interagiert, oder legt diesen fest. (Geerbt von FrameworkElement) |
| AllowFocusWhenDisabled |
Ruft ab oder legt fest, ob ein deaktiviertes Steuerelement den Fokus erhalten kann. (Geerbt von FrameworkElement) |
| BaseUri |
Ruft einen URI (Uniform Resource Identifier) ab, der den Basis-URI für ein XAML-konstruiertes Objekt zur XAML-Ladezeit darstellt. Diese Eigenschaft ist für die URI-Auflösung zur Laufzeit nützlich. (Geerbt von FrameworkElement) |
| CacheMode |
Ruft einen Wert ab, der angibt, dass gerenderter Inhalt nach Möglichkeit als zusammengesetzte Bitmap zwischengespeichert werden soll, oder legt diesen fest. (Geerbt von UIElement) |
| CanBeScrollAnchor |
Ruft einen Wert ab, der angibt, ob das UIElement ein Kandidat für scroll anchoring sein kann, oder legt diesen fest. (Geerbt von UIElement) |
| CanDrag |
Ruft einen Wert ab, der angibt, ob das Element in einem Drag-and-Drop-Vorgang als Daten gezogen werden kann, oder legt diesen fest. (Geerbt von UIElement) |
| CenterPoint |
Ruft den Mittelpunkt des Elements ab, d. h. der Punkt, an dem eine Drehung oder Skalierung stattfindet, oder legt diesen fest. Wirkt sich auf die Renderingposition des Elements aus. (Geerbt von UIElement) |
| Clip |
Ruft die RectangleGeometry ab, die zum Definieren der Gliederung des Inhalts eines UIElement verwendet wird, oder legt diese fest. (Geerbt von UIElement) |
| CompositeMode |
Ruft eine Eigenschaft ab, die alternative Kompositions- und Mischmodi für das Element im übergeordneten Layout und Fenster deklariert, oder legt sie fest. Dies ist für Elemente relevant, die an einer gemischten XAML-/Microsoft DirectX-Benutzeroberfläche beteiligt sind. (Geerbt von UIElement) |
| ContextFlyout |
Ruft das diesem Element zugeordnete Flyout ab oder legt es fest. (Geerbt von UIElement) |
| DataContext |
Ruft den Datenkontext für ein FrameworkElement ab oder legt diese fest. Ein Datenkontext wird häufig verwendet, wenn die |
| DesiredSize |
Ruft die Größe ab, die dieses UIElement während des Measuredurchlaufs des Layoutprozesses berechnet hat. (Geerbt von UIElement) |
| Dispatcher |
Gibt immer in einer Windows App SDK-App zurück |
| DispatcherQueue |
Ruft den |
| ExitDisplayModeOnAccessKeyInvoked |
Ruft einen Wert ab, der angibt, ob die Anzeige der Zugriffsschlüssel geschlossen wird, wenn ein Zugriffsschlüssel aufgerufen wird, oder legt diesen fest. (Geerbt von UIElement) |
| FlowDirection |
Ruft die Richtung ab, in der Text und andere UI-Elemente innerhalb eines übergeordneten Elements fließen, das das Layout steuert, oder legt diese fest. Diese Eigenschaft kann auf oder |
| FocusState |
Ruft einen Wert ab, der angibt, ob dieses Steuerelement den Fokus hat, und den Modus, mit dem der Fokus abgerufen wurde. (Geerbt von UIElement) |
| FocusVisualMargin |
Ruft den äußeren Rand des Fokusvisuals für ein FrameworkElement ab oder legt diese fest. (Geerbt von FrameworkElement) |
| FocusVisualPrimaryBrush |
Ruft den Pinsel ab, der zum Zeichnen des äußeren Rahmens eines |
| FocusVisualPrimaryThickness |
Ruft die Stärke des äußeren Rahmens eines Oder |
| FocusVisualSecondaryBrush |
Ruft den Pinsel ab, der verwendet wird, um den inneren Rahmen eines Oder Fokusvisuals |
| FocusVisualSecondaryThickness |
Ruft die Stärke des inneren Rahmens eines oder |
| Height |
Ruft die vorgeschlagene Höhe eines FrameworkElements ab oder legt diese fest. (Geerbt von FrameworkElement) |
| HighContrastAdjustment |
Ruft einen Wert ab, der angibt, ob das Framework die visuellen Eigenschaften des Elements automatisch anpasst, wenn Designs mit hohem Kontrast aktiviert sind, oder legt diesen fest. (Geerbt von UIElement) |
| HorizontalAlignment |
Ruft die horizontalen Ausrichtungsmerkmale ab, die auf ein FrameworkElement angewendet werden, wenn es in einem übergeordneten Layout zusammengesetzt wird, z. B. einem Panel- oder Elementsteuerelement. (Geerbt von FrameworkElement) |
| IsAccessKeyScope |
Ruft einen Wert ab, der angibt, ob ein Element seinen eigenen Zugriffsschlüsselbereich definiert, oder legt diesen fest. (Geerbt von UIElement) |
| IsDoubleTapEnabled |
Ruft einen Wert ab, der bestimmt, ob das DoubleTapped-Ereignis von diesem Element stammen kann, oder legt diesen fest. (Geerbt von UIElement) |
| IsHitTestVisible |
Ruft ab oder legt fest, ob der enthaltene Bereich dieses UIElements true-Werte für Treffertests zurückgeben kann. (Geerbt von UIElement) |
| IsHoldingEnabled |
Ruft einen Wert ab, der bestimmt, ob das Holding-Ereignis von diesem Element stammen kann, oder legt diesen fest. (Geerbt von UIElement) |
| IsLoaded |
Ruft einen Wert ab, der angibt, ob das Element der Elementstruktur hinzugefügt wurde und für die Interaktion bereit ist. (Geerbt von FrameworkElement) |
| IsRightTapEnabled |
Ruft einen Wert ab, der bestimmt, ob das RightTapped-Ereignis von diesem Element stammen kann, oder legt diesen fest. (Geerbt von UIElement) |
| IsTabStop |
Ruft einen Wert ab, der angibt, ob ein Steuerelement in der Navigation mit der TAB-TASTE enthalten ist. (Geerbt von UIElement) |
| IsTapEnabled |
Ruft einen Wert ab, der bestimmt, ob das Tapped-Ereignis von diesem Element stammen kann, oder legt diesen fest. (Geerbt von UIElement) |
| KeyboardAcceleratorPlacementMode |
Ruft einen Wert ab, der angibt, ob die QuickInfo des Steuerelements die Tastenkombination für die zugeordnete Tastenkombination anzeigt, oder legt diesen fest. (Geerbt von UIElement) |
| KeyboardAcceleratorPlacementTarget |
Ruft einen Wert ab, der die QuickInfo des Steuerelements angibt, mit der die Tastenkombination angezeigt wird, oder legt diesen fest. (Geerbt von UIElement) |
| KeyboardAccelerators |
Ruft die Auflistung von Tastenkombinationen ab, die eine Aktion mithilfe der Tastatur aufrufen. Beschleuniger werden in der Regel Schaltflächen oder Menüelementen zugewiesen.
|
| KeyTipHorizontalOffset |
Ruft einen Wert ab, der angibt, wie weit links oder rechts der Schlüsseltipp in Bezug auf das UIElement platziert wird, oder legt diesen fest. (Geerbt von UIElement) |
| KeyTipPlacementMode |
Ruft einen Wert ab, der angibt, wo der Schlüsseltipp für den Zugriffsschlüssel in Relation zur Grenze des UIElement platziert wird, oder legt diesen fest. (Geerbt von UIElement) |
| KeyTipTarget |
Ruft einen Wert ab, der das Element angibt, auf das der Schlüsseltipp für den Zugriffsschlüssel abzielt, oder legt diesen fest. (Geerbt von UIElement) |
| KeyTipVerticalOffset |
Ruft einen Wert ab, der angibt, wie weit nach oben oder unten der Schlüsseltipp in Bezug auf das UI-Element platziert wird, oder legt diesen fest. (Geerbt von UIElement) |
| Language |
Ruft Lokalisierungs-/Globalisierungssprachinformationen ab, die für ein FrameworkElement und auch für alle untergeordneten Elemente des aktuellen FrameworkElements in der Objektdarstellung und in der Benutzeroberfläche gelten, oder legt diese fest. (Geerbt von FrameworkElement) |
| Lights |
Ruft die Auflistung von XamlLight-Objekten ab, die an dieses Element angefügt sind. (Geerbt von UIElement) |
| ManipulationMode |
Ruft den ManipulationModes-Wert ab, der für das UiElement-Verhalten und die Interaktion mit Gesten verwendet wird, oder legt den Wert fest. Das Festlegen dieses Werts ermöglicht die Behandlung der Bearbeitungsereignisse dieses Elements im App-Code. (Geerbt von UIElement) |
| Margin |
Ruft den äußeren Rand eines FrameworkElements ab oder legt diese fest. (Geerbt von FrameworkElement) |
| MaxHeight |
Ruft die maximale Höheeinschränkung eines FrameworkElements ab oder legt diese fest. (Geerbt von FrameworkElement) |
| MaxWidth |
Ruft die Maximale Breiteseinschränkung eines FrameworkElements ab oder legt diese fest. (Geerbt von FrameworkElement) |
| MinHeight |
Ruft die Mindesthöheneinschränkung eines FrameworkElements ab oder legt diese fest. (Geerbt von FrameworkElement) |
| MinWidth |
Ruft die Mindestbreiteneinschränkung eines FrameworkElements ab oder legt diese fest. (Geerbt von FrameworkElement) |
| Name |
Ruft den identifizierenden Namen des Objekts ab oder legt diese fest. Wenn ein XAML-Prozessor die Objektstruktur aus XAML-Markup erstellt, kann Laufzeitcode mit diesem Namen auf das XAML-deklarierte Objekt verweisen. (Geerbt von FrameworkElement) |
| NineGrid |
Ruft einen Wert für eine Metapher mit neun Rastern ab, die steuert, wie die Größe des Bilds geändert werden kann, oder legt diesen fest. Die Metapher mit neun Rastern ermöglicht es Ihnen, Kanten und Ecken eines Bilds anders als seine Mitte zu strecken. Weitere Informationen und eine Abbildung finden Sie unter Hinweise. |
| NineGridProperty |
Identifiziert die NineGrid-Abhängigkeitseigenschaft . |
| Opacity |
Ruft den Grad der Deckkraft des Objekts ab oder legt diese fest. (Geerbt von UIElement) |
| OpacityTransition |
Ruft die ScalarTransition ab, die Änderungen an der Opacity-Eigenschaft animiert, oder legt sie fest. (Geerbt von UIElement) |
| Parent |
Ruft das übergeordnete Objekt dieses FrameworkElements in der Objektstruktur ab. (Geerbt von FrameworkElement) |
| PointerCaptures |
Ruft den Satz aller erfassten Zeiger ab, die als Zeigerwerte dargestellt werden. (Geerbt von UIElement) |
| Projection |
Ruft die perspektivische Projektion (3D-Effekt) ab, die beim Rendern dieses Elements angewendet werden soll, oder legt diese fest. (Geerbt von UIElement) |
| ProtectedCursor |
Ruft den Cursor ab, der angezeigt wird, wenn sich der Zeiger über dieses Element befindet, oder legt diesen fest. Standardmäßig null, was angibt, dass sich der Cursor nicht ändert. (Geerbt von UIElement) |
| RasterizationScale |
Ruft einen Wert ab, der die Anzahl der unformatierten (physischen) Pixel für jedes Ansichtspixel darstellt. (Geerbt von UIElement) |
| RenderSize |
Ruft die endgültige Rendergröße eines UIElement ab. Die Verwendung wird nicht empfohlen, siehe Hinweise. (Geerbt von UIElement) |
| RenderTransform |
Ruft Transformationsinformationen ab, die sich auf die Renderingposition eines UIElements auswirken, oder legt diese fest. (Geerbt von UIElement) |
| RenderTransformOrigin |
Ruft den Ursprungspunkt einer beliebigen von RenderTransform deklarierten Rendertransform-Transformation relativ zu den Begrenzungen des UIElement ab oder legt diesen fest. (Geerbt von UIElement) |
| RequestedTheme |
Ruft das UI-Design ab, das vom UIElement (und seinen untergeordneten Elementen) für die Ressourcenbestimmung verwendet wird, oder legt es fest. Das UI-Design, das Sie mit |
| Resources |
Ruft das lokal definierte Ressourcenverzeichnis ab. In XAML können Sie Ressourcenelemente als untergeordnete Objektelemente eines |
| Rotation |
Ruft den Winkel der Drehung im Uhrzeigersinn in Grad ab oder legt diesen fest. Dreht sich relativ zu RotationAxis und CenterPoint. Wirkt sich auf die Renderingposition des Elements aus. (Geerbt von UIElement) |
| RotationAxis |
Ruft die Achse ab, um die das Element gedreht werden soll, oder legt sie fest. (Geerbt von UIElement) |
| RotationTransition |
Ruft die ScalarTransition ab, die Änderungen an der Rotation-Eigenschaft animiert, oder legt sie fest. (Geerbt von UIElement) |
| Scale |
Ruft die Skalierung des Elements ab oder legt sie fest. Skaliert relativ zum CenterPoint des Elements. Wirkt sich auf die Renderingposition des Elements aus. (Geerbt von UIElement) |
| ScaleTransition |
Ruft den Vector3Transition ab, der Änderungen an der Scale-Eigenschaft animiert, oder legt diesen fest. (Geerbt von UIElement) |
| Shadow |
Ruft den Schatteneffekt ab, der vom -Element umgewandelt wird, oder legt diese fest. (Geerbt von UIElement) |
| Source |
Ruft die Quelle für das Bild ab oder legt sie fest. |
| SourceProperty |
Identifiziert die Source-Abhängigkeitseigenschaft . |
| Stretch |
Ruft einen Wert ab, der beschreibt, wie ein Bild gestreckt werden soll, um das Zielrechteck auszufüllen, oder legt diesen fest. |
| StretchProperty | |
| 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) |
| TabIndex |
Ruft einen Wert ab, der die Reihenfolge bestimmt, in der Elemente den Fokus erhalten, wenn der Benutzer mithilfe der TAB-TASTE durch Steuerelemente navigiert, oder legt diesen fest. (Geerbt von UIElement) |
| Tag |
Ruft einen beliebigen Objektwert ab, der zum Speichern benutzerdefinierter Informationen zu diesem Objekt verwendet werden kann, oder legt diesen fest. (Geerbt von FrameworkElement) |
| Transform3D |
Ruft den 3D-Transformationseffekt ab, der beim Rendern dieses Elements angewendet werden soll, oder legt diesen fest. (Geerbt von UIElement) |
| TransformMatrix |
Ruft die Transformationsmatrix ab, die auf das Element angewendet werden soll, oder legt diese fest. (Geerbt von UIElement) |
| Transitions |
Ruft die Auflistung von Transition-Stilelementen ab, die für ein UIElement gelten, oder legt diese fest. (Geerbt von UIElement) |
| Translation |
Ruft die x-, y- und z-Renderingposition des Elements ab oder legt diese fest. (Geerbt von UIElement) |
| TranslationTransition |
Ruft den Vector3Transition ab, der Änderungen an der Translation-Eigenschaft animiert, oder legt diesen fest. (Geerbt von UIElement) |
| Triggers |
Ruft die Auflistung von Triggern für Animationen ab, die für ein FrameworkElement definiert sind. Nicht häufig verwendet. Siehe Hinweise. (Geerbt von FrameworkElement) |
| UseLayoutRounding |
Ruft einen Wert ab, der bestimmt, ob das Rendering für das Objekt und seine visuelle Unterstruktur ein Rundungsverhalten verwenden soll, das das Rendering auf ganze Pixel ausrichtet, oder legt diesen fest. (Geerbt von UIElement) |
| UseSystemFocusVisuals |
Ruft einen Wert ab, der angibt, ob das Steuerelement Vom System gezeichnete Fokusvisuals oder Fokusvisuals verwendet, die in der Steuerelementvorlage definiert sind, oder legt diesen fest. (Geerbt von UIElement) |
| VerticalAlignment |
Ruft die vertikalen Ausrichtungsmerkmale ab, die auf ein FrameworkElement angewendet werden, wenn es in einem übergeordneten Objekt wie einem Panel- oder Elementsteuerelement zusammengesetzt ist, oder legt diese fest. (Geerbt von FrameworkElement) |
| Visibility |
Ruft die Sichtbarkeit eines UIElements ab oder legt diese fest. Ein |
| Width |
Ruft die Breite eines FrameworkElements ab oder legt diese fest. (Geerbt von FrameworkElement) |
| XamlRoot |
Ruft die ab, in der |
| XYFocusDown |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer auf das Richtungspad (D-Pad) eines Spielcontrollers drückt, oder legt es fest. (Geerbt von UIElement) |
| XYFocusDownNavigationStrategy |
Ruft einen Wert ab, der die Strategie angibt, mit der das Zielelement einer Navigation nach unten bestimmt wird, oder legt diesen fest. (Geerbt von UIElement) |
| XYFocusKeyboardNavigation |
Ruft einen Wert ab, der die Navigation mithilfe der Richtungspfeile der Tastatur aktiviert oder deaktiviert, oder legt diesen fest. (Geerbt von UIElement) |
| XYFocusLeft |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer links auf das Richtungspad (D-Pad) eines Spielcontrollers drückt, oder legt es fest. (Geerbt von UIElement) |
| XYFocusLeftNavigationStrategy |
Ruft einen Wert ab, der die Strategie angibt, die zum Bestimmen des Zielelements einer linken Navigation verwendet wird, oder legt diesen fest. (Geerbt von UIElement) |
| XYFocusRight |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer direkt auf das Richtungspad (D-Pad) eines Spielcontrollers drückt, oder legt es fest. (Geerbt von UIElement) |
| XYFocusRightNavigationStrategy |
Ruft einen Wert ab, der die Strategie angibt, mit der das Zielelement einer rechten Navigation bestimmt wird, oder legt diesen fest. (Geerbt von UIElement) |
| XYFocusUp |
Ruft das Objekt ab, das den Fokus erhält, wenn ein Benutzer auf das Richtungspad (D-Pad) eines Spielcontrollers drückt, oder legt es fest. (Geerbt von UIElement) |
| XYFocusUpNavigationStrategy |
Ruft einen Wert ab, der die Strategie angibt, mit der das Zielelement einer Navigation nach oben bestimmt wird, oder legt diesen fest. (Geerbt von UIElement) |
Methoden
| AddHandler(RoutedEvent, Object, Boolean) |
Fügt einen Routingereignishandler für ein bestimmtes Routingereignis hinzu, wobei der Handler der Handlerauflistung für das aktuelle Element hinzugefügt wird. Geben Sie |
| Arrange(Rect) |
Positioniert untergeordnete Objekte und bestimmt eine Größe für ein UIElement. Übergeordnete Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Elemente implementieren, sollten diese Methode aus ihren Layoutüberschreibungsimplementierungen aufrufen, um eine rekursive Layoutaktualisierung zu bilden. (Geerbt von UIElement) |
| ArrangeOverride(Size) |
Stellt das Verhalten für den Layoutdurchlauf "Anordnen" bereit. Klassen können diese Methode überschreiben, um ihr eigenes "Arrange"-Passverhalten zu definieren. (Geerbt von FrameworkElement) |
| CancelDirectManipulations() |
Bricht die laufende verarbeitung der direkten Bearbeitung (systemdefiniertes Schwenken/Zoomen) für alle übergeordneten ScrollViewer-Elemente ab, die das aktuelle UIElement enthalten. (Geerbt von UIElement) |
| CapturePointer(Pointer) |
Legt die Zeigererfassung auf ein UIElement fest. Nach der Erfassung löst nur das Element, das über capture verfügt, zeigerbezogene Ereignisse aus. (Geerbt von UIElement) |
| ClearValue(DependencyProperty) |
Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject) |
| FindName(String) |
Ruft ein Objekt ab, das über den angegebenen Bezeichnernamen verfügt. (Geerbt von FrameworkElement) |
| FindSubElementsForTouchTargeting(Point, Rect) |
Ermöglicht es einer UIElement-Unterklasse , untergeordnete Elemente verfügbar zu machen, die beim Auflösen der Touchadressierung helfen. (Geerbt von UIElement) |
| Focus(FocusState) |
Versucht, den Fokus auf dieses Element festzulegen. (Geerbt von UIElement) |
| GetAlphaMask() |
Gibt eine Maske zurück, die den Alphakanal eines Bilds als CompositionBrush darstellt. |
| GetAnimationBaseValue(DependencyProperty) |
Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, der in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject) |
| GetAsCastingSource() |
Gibt das Bild als CastingSource zurück. |
| GetBindingExpression(DependencyProperty) |
Gibt den BindingExpression zurück, der die Bindung für die angegebene Eigenschaft darstellt. (Geerbt von FrameworkElement) |
| GetChildrenInTabFocusOrder() |
Ermöglicht einer UIElement-Unterklasse , untergeordnete Elemente verfügbar zu machen, die am Tabstopp-Fokus teilnehmen. (Geerbt von UIElement) |
| GetValue(DependencyProperty) |
Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject) |
| GetVisualInternal() |
Ruft die |
| GoToElementStateCore(String, Boolean) |
Aktiviert bei Implementierung in einer abgeleiteten Klasse die Erstellung einer visuellen Struktur pro Zustand für eine Steuerelementvorlage im Code, anstatt XAML für alle Zustände beim Start des Steuerelements zu laden. (Geerbt von FrameworkElement) |
| InvalidateArrange() |
Ungültig wird der Anordnungszustand (Layout) für ein UIElement. Nach der Ungültigkeit wird das Layout des UIElement aktualisiert, was asynchron erfolgt. (Geerbt von UIElement) |
| InvalidateMeasure() |
Ungültig wird der Messzustand (Layout) für ein UIElement. (Geerbt von UIElement) |
| InvalidateViewport() |
Ungültig wird der Viewportzustand für ein UIElement , das zum Berechnen des effektiven Viewports verwendet wird. (Geerbt von FrameworkElement) |
| Measure(Size) |
Updates desiredSize eines UIElements aus. In der Regel rufen Objekte, die ein benutzerdefiniertes Layout für ihre untergeordneten Layoutelemente implementieren, diese Methode aus ihren eigenen MeasureOverride-Implementierungen auf, um ein rekursives Layoutupdate zu bilden. (Geerbt von UIElement) |
| MeasureOverride(Size) |
Stellt das Verhalten für den Durchlauf "Measure" des Layoutzyklus bereit. Klassen können diese Methode überschreiben, um ihr eigenes "Measure"-Passverhalten zu definieren. (Geerbt von FrameworkElement) |
| OnApplyTemplate() |
Wird immer aufgerufen, wenn Anwendungscode oder interne Prozesse (z. B. ein neuerstellender Layoutdurchlauf) ApplyTemplate aufrufen. Vereinfacht ausgedrückt bedeutet dies, dass die -Methode aufgerufen wird, bevor ein UI-Element in Ihrer App angezeigt wird. Überschreiben Sie diese Methode, um die Standardlogik nach der Vorlage einer Klasse zu beeinflussen. (Geerbt von FrameworkElement) |
| OnBringIntoViewRequested(BringIntoViewRequestedEventArgs) |
Wird aufgerufen, bevor das BringIntoViewRequested-Ereignis auftritt. (Geerbt von UIElement) |
| OnCreateAutomationPeer() |
Gibt bei Implementierung in einer abgeleiteten Klasse klassenspezifische AutomationPeer-Implementierungen für die Microsoft Benutzeroberflächenautomatisierung-Infrastruktur zurück. (Geerbt von UIElement) |
| OnDisconnectVisualChildren() |
Überschreiben Sie diese Methode, um zu implementieren, wie sich Layout und Logik verhalten sollen, wenn Elemente aus einem klassenspezifischen Inhalt oder einer untergeordneten Eigenschaft entfernt werden. (Geerbt von UIElement) |
| OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs) |
Wird aufgerufen, wenn eine Tastenkombination (oder Einschleunigung) in Ihrer App verarbeitet wird. Überschreiben Sie diese Methode, um zu behandeln, wie Ihre App reagiert, wenn eine Tastenkombination aufgerufen wird. (Geerbt von UIElement) |
| OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs) |
Wird aufgerufen, kurz bevor eine Tastenkombination (oder Einschleunigung) in Ihrer App verarbeitet wird. Wird immer aufgerufen, wenn Anwendungscode oder interne Prozesse ProcessKeyboardAccelerators aufrufen. Überschreiben Sie diese Methode, um die Standardbeschleunigung zu beeinflussen. (Geerbt von UIElement) |
| PopulatePropertyInfo(String, AnimationPropertyInfo) |
Definiert eine Eigenschaft, die animiert werden kann. (Geerbt von UIElement) |
| PopulatePropertyInfoOverride(String, AnimationPropertyInfo) |
Definiert beim Überschreiben in einer abgeleiteten Klasse eine Eigenschaft, die animiert werden kann. (Geerbt von UIElement) |
| ReadLocalValue(DependencyProperty) |
Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject) |
| RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für 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 eine Bindung mithilfe des bereitgestellten Bindungsobjekts an ein FrameworkElement an. (Geerbt von FrameworkElement) |
| SetValue(DependencyProperty, Object) |
Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject) |
| StartAnimation(ICompositionAnimationBase) |
Startet die angegebene Animation für das -Element. (Geerbt von UIElement) |
| StartBringIntoView() |
Initiiert eine Anforderung an das XAML-Framework, um das Element in allen scrollbaren Regionen anzuzeigen, in dem es enthalten ist. (Geerbt von UIElement) |
| StartBringIntoView(BringIntoViewOptions) |
Initiiert eine Anforderung an das XAML-Framework, um das Element mithilfe der angegebenen Optionen anzuzeigen. (Geerbt von UIElement) |
| StartDragAsync(ExpPointerPoint) |
Stellt ein 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. (Geerbt von UIElement) |
| StartDragAsync(PointerPoint) |
Leitet einen Drag & Drop-Vorgang ein. Wichtig Wird nicht unterstützt, wenn ein Benutzer die App als Administrator im Modus mit erhöhten Rechten ausführt. |
| StopAnimation(ICompositionAnimationBase) |
Beendet die angegebene Animation für das -Element. (Geerbt von UIElement) |
| TransformToVisual(UIElement) |
Gibt ein Transformationsobjekt zurück, das verwendet werden kann, um Koordinaten vom UIElement in das angegebene Objekt zu transformieren. (Geerbt von UIElement) |
| TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs) |
Versucht, eine Tastenkombination (oder einen Accelerator) aufzurufen, indem die gesamte visuelle Struktur des UIElements nach der Verknüpfung durchsucht wird. (Geerbt von UIElement) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject) |
| UpdateLayout() |
Stellt sicher, dass alle Positionen untergeordneter Objekte eines UIElements ordnungsgemäß für das Layout aktualisiert werden. (Geerbt von UIElement) |
Ereignisse
| AccessKeyDisplayDismissed |
Tritt auf, wenn Zugriffsschlüssel nicht mehr angezeigt werden sollen. (Geerbt von UIElement) |
| AccessKeyDisplayRequested |
Tritt auf, wenn der Benutzer anfordert, dass Zugriffsschlüssel angezeigt werden. (Geerbt von UIElement) |
| AccessKeyInvoked |
Tritt auf, wenn ein Benutzer eine Zugriffstastensequenz abschließt. (Geerbt von UIElement) |
| ActualThemeChanged |
Tritt auf, wenn sich der Wert der ActualTheme-Eigenschaft geändert hat. (Geerbt von FrameworkElement) |
| BringIntoViewRequested |
Tritt auf, wenn StartBringIntoView für dieses Element oder eines seiner Nachfolger aufgerufen wird. (Geerbt von UIElement) |
| CharacterReceived |
Tritt auf, wenn ein einzelnes zusammengesetztes Zeichen von der Eingabewarteschlange empfangen wird. (Geerbt von UIElement) |
| ContextCanceled |
Tritt auf, wenn eine Kontexteingabegeste zu einer Bearbeitungsgeste fortgesetzt wird, um das Element zu benachrichtigen, dass das Kontextflyout nicht geöffnet werden soll. (Geerbt von UIElement) |
| ContextRequested |
Tritt auf, wenn der Benutzer eine Kontexteingabegeste abgeschlossen hat, z. B. einen Rechtsklick. (Geerbt von UIElement) |
| DataContextChanged |
Tritt auf, wenn sich der Wert der FrameworkElement.DataContext-Eigenschaft ändert. (Geerbt von FrameworkElement) |
| DoubleTapped |
Tritt auf, wenn eine ansonsten nicht behandelte DoubleTap-Interaktion über dem Treffertestbereich dieses Elements auftritt. (Geerbt von UIElement) |
| DragEnter |
Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ziehereignis mit diesem Element als Ziel meldet. (Geerbt von UIElement) |
| DragLeave |
Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ziehereignis mit diesem Element als Ursprung meldet. (Geerbt von UIElement) |
| DragOver |
Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Drag-Ereignis mit diesem Element als potenzielles Drop-Ziel meldet. (Geerbt von UIElement) |
| DragStarting |
Tritt auf, wenn ein Ziehvorgang initiiert wird. (Geerbt von UIElement) |
| Drop |
Tritt auf, wenn das Eingabesystem ein zugrunde liegendes Ablageereignis meldet, das dieses Element als Ablageziel aufweist. (Geerbt von UIElement) |
| DropCompleted |
Tritt auf, wenn ein Drag-and-Drop-Vorgang mit diesem Element als Quelle beendet wird. (Geerbt von UIElement) |
| EffectiveViewportChanged |
Tritt auf, wenn sich der effektive Viewport des FrameworkElements ändert. (Geerbt von FrameworkElement) |
| GettingFocus |
Tritt auf, bevor ein UIElement den Fokus erhält. Dieses Ereignis wird synchron ausgelöst, um sicherzustellen, dass der Fokus nicht verschoben wird, während das Ereignis sprudelt. (Geerbt von UIElement) |
| GotFocus |
Tritt auf, wenn ein UIElement den Fokus erhält. Dieses Ereignis wird asynchron ausgelöst, sodass der Fokus erneut verschoben werden kann, bevor das Sprudeln abgeschlossen ist. (Geerbt von UIElement) |
| Holding |
Tritt auf, wenn eine ansonsten nicht behandelte Hold-Interaktion über dem Treffertestbereich dieses Elements erfolgt. (Geerbt von UIElement) |
| ImageFailed |
Tritt auf, wenn ein Fehler im Zusammenhang mit dem Bildabruf oder -format auftritt. |
| ImageOpened |
Tritt auf, wenn die Imagequelle heruntergeladen und ohne Fehler decodiert wird. Sie können dieses Ereignis verwenden, um die natürliche Größe der Bildquelle zu bestimmen. |
| KeyDown |
Tritt auf, wenn eine Tastaturtaste gedrückt wird, während das UIElement den Fokus hat. (Geerbt von UIElement) |
| KeyUp |
Tritt auf, wenn eine Tastaturtaste losgelassen wird, während das UIElement den Fokus hat. (Geerbt von UIElement) |
| LayoutUpdated |
Tritt auf, wenn sich das Layout der visuellen Struktur ändert, weil layoutrelevante Eigenschaften den Wert ändern oder eine andere Aktion, die das Layout aktualisiert. (Geerbt von FrameworkElement) |
| Loaded |
Tritt auf, wenn ein FrameworkElement erstellt und der Objektstruktur hinzugefügt wurde und für die Interaktion bereit ist. (Geerbt von FrameworkElement) |
| Loading |
Tritt auf, wenn ein FrameworkElement zu laden beginnt. (Geerbt von FrameworkElement) |
| LosingFocus |
Tritt auf, bevor ein UIElement den Fokus verliert. Dieses Ereignis wird synchron ausgelöst, um sicherzustellen, dass der Fokus nicht verschoben wird, während das Ereignis sprudelt. (Geerbt von UIElement) |
| LostFocus |
Tritt auf, wenn ein UIElement den Fokus verliert. Dieses Ereignis wird asynchron ausgelöst, sodass der Fokus erneut verschoben werden kann, bevor das Sprudeln abgeschlossen ist. (Geerbt von UIElement) |
| ManipulationCompleted |
Tritt auf, wenn eine Bearbeitung am UIElement abgeschlossen ist. (Geerbt von UIElement) |
| ManipulationDelta |
Tritt ein, wenn sich die Position des Eingabegeräts während einer Bearbeitung ändert. (Geerbt von UIElement) |
| ManipulationInertiaStarting |
Tritt auf, wenn das Eingabegerät während einer Bearbeitung Kontakt mit dem UIElement-Objekt verliert und die Trägheit beginnt. (Geerbt von UIElement) |
| ManipulationStarted |
Tritt auf, wenn ein Eingabegerät mit einer Bearbeitung des UIElement beginnt. (Geerbt von UIElement) |
| ManipulationStarting |
Tritt bei der ersten Erstellung des Manipulationsprozessors auf. (Geerbt von UIElement) |
| NoFocusCandidateFound |
Tritt auf, wenn ein Benutzer versucht, den Fokus zu verschieben (über Tabstopp- oder Richtungspfeile), der Fokus jedoch nicht bewegt wird, weil kein Fokuskandidat in Bewegungsrichtung gefunden wird. (Geerbt von UIElement) |
| PointerCanceled |
Tritt auf, wenn ein Zeiger, der den Kontakt hergestellt hat, den Kontakt anormal verliert. (Geerbt von UIElement) |
| PointerCaptureLost |
Tritt auf, wenn die Zeigererfassung, die zuvor von diesem Element gehalten wurde, zu einem anderen Element oder an eine andere Stelle verschoben wird. (Geerbt von UIElement) |
| PointerEntered |
Tritt auf, wenn ein Zeiger in den Treffertestbereich dieses Elements eintritt. (Geerbt von UIElement) |
| PointerExited |
Tritt auf, wenn ein Zeiger den Treffertestbereich dieses Elements verlässt. (Geerbt von UIElement) |
| PointerMoved |
Tritt auf, wenn 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 das Ende einer Press-Aktion nicht garantiert, dass ein |
| PointerWheelChanged |
Tritt auf, wenn sich der Deltawert eines Zeigers ändert. (Geerbt von UIElement) |
| PreviewKeyDown |
Tritt auf, wenn eine Tastaturtaste gedrückt wird, während das UIElement den Fokus hat. (Geerbt von UIElement) |
| PreviewKeyUp |
Tritt auf, wenn eine Tastaturtaste 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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für