Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

TranslateTransform-Klasse

Verschiebt ein Objekt im 2-D-x-y-Koordinatensystem.

Namespace:  System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS für XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
public sealed class TranslateTransform : Transform
<TranslateTransform .../>

Der TranslateTransform-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeTranslateTransform()Initialisiert eine neue Instanz der TranslateTransform-Klasse.
Öffentliche MethodeTranslateTransform(Double, Double)Initialisiert eine neue Instanz der TranslateTransform-Klasse und gibt die Verschiebungen in Richtung der x-und y-Achse an.
Zum Seitenanfang
  NameBeschreibung
Öffentliche EigenschaftCanFreezeRuft einen Wert ab, der angibt, ob das Objekt als nicht änderbar festgelegt werden kann. (Von Freezable geerbt.)
Öffentliche EigenschaftDependencyObjectTypeRuft den DependencyObjectType ab, der den CLR-Typ dieser Instanz umschließt.  (Von DependencyObject geerbt.)
Öffentliche EigenschaftDispatcherRuft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Von DispatcherObject geerbt.)
Öffentliche EigenschaftHasAnimatedPropertiesRuft einen Wert ab, der angibt, ob einer der Abhängigkeitseigenschaften dieses Objekts ein oder mehrere AnimationClock-Objekte zugeordnet sind. (Von Animatable geerbt.)
Öffentliche EigenschaftInverseRuft ggf. die Umkehrfunktion der Transformation ab. (Von Transform geerbt.)
Öffentliche EigenschaftIsFrozenRuft einen Wert ab, der angibt, ob das Objekt gegenwärtig änderbar ist. (Von Freezable geerbt.)
Öffentliche EigenschaftIsSealedRuft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Von DependencyObject geerbt.)
Öffentliche EigenschaftValueRuft eine Matrix-Darstellung des TranslateTransform ab. (Überschreibt Transform.Value.)
Öffentliche EigenschaftXRuft die Strecke der Verschiebung auf der x-Achse ab oder legt diese fest.
Öffentliche EigenschaftYRuft die Strecke der Verschiebung eines Objekts auf der y-Achse ab oder legt diese fest.
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeApplyAnimationClock(DependencyProperty, AnimationClock)Wendet eine AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Von Animatable geerbt.)
Öffentliche MethodeApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)Wendet eine AnimationClock auf die angegebene DependencyProperty an. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Von Animatable geerbt.)
Öffentliche MethodeBeginAnimation(DependencyProperty, AnimationTimeline)Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn das nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet. (Von Animatable geerbt.)
Öffentliche MethodeBeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)Wendet eine Animation auf die angegebene DependencyProperty an. Die Animation wird gestartet, wenn das nächste Frame gerendert wird. Wenn die angegebene Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet. (Von Animatable geerbt.)
Öffentliche MethodeCheckAccessBestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
Öffentliche MethodeClearValue(DependencyProperty)Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyProperty-Bezeichner angegeben. (Von DependencyObject geerbt.)
Öffentliche MethodeClearValue(DependencyPropertyKey)Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird mit einem DependencyPropertyKey angegeben. (Von DependencyObject geerbt.)
Öffentliche MethodeCloneErstellt eine änderbare Kopie des TranslateTransform, indem tiefe Kopien seiner Werte erzeugt werden.
Geschützte MethodeCloneCoreDefiniert die Instanz als Klon (tiefe Kopie) des angegebenen Freezable mit Basiseigenschaftswerten (nicht animiert). (Von Freezable geerbt.)
Öffentliche MethodeCloneCurrentValueErstellt eine änderbare Kopie des TranslateTransform-Objekts, indem tiefe Kopien seiner Werte erzeugt werden. Diese Methode kopiert keine Ressourcenverweise, Datenbindungen und Animationen, obwohl sie ihre aktuellen Werte kopiert.
Geschützte MethodeCloneCurrentValueCoreDefiniert die Instanz mit aktuellen Eigenschaftswerten als änderbaren Klon (tiefe Kopie) des angegebenen Freezable. (Von Freezable geerbt.)
Öffentliche MethodeCoerceValueWandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Für die Umwandlung wird eine vorhandene CoerceValueCallback-Funktion aufgerufen, die in den Metadaten der Abhängigkeitseigenschaft für das aufrufende DependencyObject angegeben ist. (Von DependencyObject geerbt.)
Geschützte MethodeCreateInstanceInitialisiert eine neue Instanz der Freezable-Klasse. (Von Freezable geerbt.)
Geschützte MethodeCreateInstanceCoreErstellt beim Implementieren in einer abgeleiteten Klasse eine neue Instanz der abgeleiteten Freezable-Klasse. (Von Freezable geerbt.)
Öffentliche MethodeEqualsBestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Von DependencyObject geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeFreeze()Definiert das aktuelle Objekt als nicht änderbar und legt seine IsFrozen-Eigenschaft auf true fest. (Von Freezable geerbt.)
Geschützte MethodeFreezeCoreLegt dieses Animatable-Objekt als nicht änderbar fest oder bestimmt, ob es als nicht änderbar festgelegt werden kann. (Von Animatable geerbt.)
Öffentliche MethodeGetAnimationBaseValueGibt den nicht animierten Wert der angegebenen DependencyProperty zurück. (Von Animatable geerbt.)
Öffentliche MethodeGetAsFrozenErstellt eine fixierte Kopie von Freezable mit Basiseigenschaftswerten (nicht animiert). Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Von Freezable geerbt.)
Geschützte MethodeGetAsFrozenCoreDefiniert die Instanz als fixierten Klon des angegebenen Freezable mit Basiseigenschaftswerten (nicht animiert). (Von Freezable geerbt.)
Öffentliche MethodeGetCurrentValueAsFrozenErstellt eine fixierte Kopie von Freezable mit aktuellen Eigenschaftswerten. Da die Kopie fixiert ist, werden alle fixierten Unterobjekte als Verweis kopiert. (Von Freezable geerbt.)
Geschützte MethodeGetCurrentValueAsFrozenCoreLegt die aktuelle Instanz als fixierten Klon des angegebenen Freezable fest. Wenn das Objekt über animierte Abhängigkeitseigenschaften verfügt, werden die aktuellen animierten Werte kopiert. (Von Freezable geerbt.)
Öffentliche MethodeGetHashCodeRuft einen Hashcode für dieses DependencyObject ab. (Von DependencyObject geerbt.)
Öffentliche MethodeGetLocalValueEnumeratorErstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Von DependencyObject geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeGetValueGibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft in dieser Instanz eines DependencyObject zurück. (Von DependencyObject geerbt.)
Öffentliche MethodeInvalidatePropertyBerechnet den effektiven Wert für die angegebene Abhängigkeitseigenschaft neu (Von DependencyObject geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte MethodeOnChangedWird aufgerufen, wenn das aktuelle Freezable-Objekt geändert wird. (Von Freezable geerbt.)
Geschützte MethodeOnFreezablePropertyChanged(DependencyObject, DependencyObject)Stellt sicher, dass entsprechende Kontextzeiger für einen gerade festgelegten DependencyObjectType-Datenmember eingerichtet werden. (Von Freezable geerbt.)
Geschützte MethodeOnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)Der Member unterstützt die Windows Presentation Foundation (WPF)-Infrastruktur und ist nicht für die direkte Verwendung im Code vorgesehen. (Von Freezable geerbt.)
Geschützte MethodeOnPropertyChangedÜberschreibt die DependencyObject-Implementierung von OnPropertyChanged, um auch alle Changed-Handler als Reaktion auf eine Änderung einer Abhängigkeitseigenschaft vom Typ Freezable aufzurufen. (Von Freezable geerbt.)
Öffentliche MethodeReadLocalValueGibt, sofern vorhanden, den lokalen Wert einer Abhängigkeitseigenschaft zurück. (Von DependencyObject geerbt.)
Geschützte MethodeReadPreambleStellt sicher, dass über einen gültigen Thread auf Freezable zugegriffen wird. Erben von Freezable müssen diese Methode am Anfang jeder API aufrufen, die Datenmember liest, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Von Freezable geerbt.)
Öffentliche MethodeSetCurrentValueLegt den Wert einer -Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Von DependencyObject geerbt.)
Öffentliche MethodeSetValue(DependencyProperty, Object)Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die über ihren Bezeichner angegeben wird. (Von DependencyObject geerbt.)
Öffentliche MethodeSetValue(DependencyPropertyKey, Object)Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die über ihren DependencyPropertyKey-Bezeichner angegeben wird. (Von DependencyObject geerbt.)
Geschützte MethodeShouldSerializePropertyGibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Von DependencyObject geerbt.)
Öffentliche MethodeToString()Erstellt eine Zeichenfolgendarstellung des GeneralTransform. (Von GeneralTransform geerbt.)
Öffentliche MethodeToString(IFormatProvider)Erstellt eine Zeichenfolgendarstellung dieser Instanz anhand des übergebenen IFormatProvider-Parameters. (Von GeneralTransform geerbt.)
Öffentliche MethodeTransformTransformiert den angegebenen Punkt und gibt das Ergebnis zurück. (Von GeneralTransform geerbt.)
Öffentliche MethodeTransformBoundsTransformiert das angegebene umgebende Feld und gibt ein an einer Achse ausgerichtetes umgebendes Feld zurück, dessen Größe genau für das Rechteck ausreicht. (Von Transform geerbt.)
Öffentliche MethodeTryTransformVersucht, den angegebenen Punkt zu transformieren, und gibt einen Wert zurück, der angibt, ob die Transformation erfolgreich durchgeführt wurde. (Von Transform geerbt.)
Öffentliche MethodeVerifyAccessErzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Von DispatcherObject geerbt.)
Geschützte MethodeWritePostscriptLöst das Changed-Ereignis für Freezable aus und ruft seine OnChanged-Methode auf. Von Freezable abgeleitete Klassen sollten diese Methode am Ende jeder API aufrufen, die nicht als Abhängigkeitseigenschaften gespeicherte Klassenmember ändert. (Von Freezable geerbt.)
Geschützte MethodeWritePreambleStellt sicher, dass das Freezable nicht fixiert ist und dass über einen gültigen Threadkontext darauf zugegriffen wird. Erben von Freezable sollten diese Methode am Anfang jeder API aufrufen, die Datenmember schreibt, bei denen es sich nicht um Abhängigkeitseigenschaften handelt. (Von Freezable geerbt.)
Zum Seitenanfang
  NameBeschreibung
Öffentliches EreignisChangedTritt auf, wenn Freezable oder ein darin enthaltenes Objekt geändert wird. (Von Freezable geerbt.)
Zum Seitenanfang
  NameBeschreibung
Öffentliches FeldStatischer MemberXPropertyBezeichnet die X-Abhängigkeitseigenschaft.
Öffentliches FeldStatischer MemberYPropertyBezeichnet die Y-Abhängigkeitseigenschaft.
Zum Seitenanfang
  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeIFormattable.ToStringFormatiert den Wert der aktuellen Instanz unter Verwendung des angegebenen Formats. (Von GeneralTransform geerbt.)
Zum Seitenanfang

TranslateTransform definiert eine an Achsen ausgerichtete Verschiebung entlang der x- und y-Achse. In der folgenden Abbildung wird die Transformationsmatrix für eine Verschiebung mit dem Offset (dx, dy) gezeigt.

Typische 3x3-Matrix für 2D-Verschiebungen

Verschieben der Matrix 100010dxdy1

Features von Freezable: Weil die TranslateTransform-Klasse von der Freezable-Klasse erbt, stellt sie mehrere spezielle Features bereit: TranslateTransform-Objekte können als Ressourcen deklariert, von mehreren Objekten gleichzeitig verwendet, für eine höhere Leistung als schreibgeschützt definiert, geklont und als threadsicher festgelegt werden. Weitere Informationen über die verschiedenen von Freezable-Objekten bereitgestellten Features finden Sie unter Übersicht über Freezable-Objekte.

This example shows how to translate (move) an element by using a TranslateTransform.

The TranslateTransform class is especially useful for moving elements inside panels that do not support absolute positioning. For example, by applying a TranslateTransform to the RenderTransform property of an element, you can move an element within a StackPanel or DockPanel.

Use the X property of the TranslateTransform to specify the amount, in pixels, to move the element along the x-axis. Use the Y property to specify the amount, in pixels, to move the element along the y-axis. Finally, apply the TranslateTransform to the RenderTransform property of the element.

The following example uses a TranslateTransform to move an element 50 pixels to the right and 50 pixels down.


<Rectangle Height="50" Width="50" 
  Fill="#CCCCCCFF" Stroke="Blue" StrokeThickness="2"
  Canvas.Left="100" Canvas.Top="100">
  <Rectangle.RenderTransform>
    <TranslateTransform X="50" Y="50" />
  </Rectangle.RenderTransform>
</Rectangle>


For the complete sample, see 2-D Transforms Sample.

.NET Framework

Unterstützt in: 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.