RenderOptions.SetBitmapScalingMode(DependencyObject, BitmapScalingMode) Methode

Definition

Legt den Wert der angefügten BitmapScalingMode-Eigenschaft für ein angegebenes Abhängigkeitsobjekt fest.Sets the value of the BitmapScalingMode attached property on a specified dependency object.

public:
 static void SetBitmapScalingMode(System::Windows::DependencyObject ^ target, System::Windows::Media::BitmapScalingMode bitmapScalingMode);
public static void SetBitmapScalingMode (System.Windows.DependencyObject target, System.Windows.Media.BitmapScalingMode bitmapScalingMode);
static member SetBitmapScalingMode : System.Windows.DependencyObject * System.Windows.Media.BitmapScalingMode -> unit

Parameter

target
DependencyObject

Der UIElement- oder der DrawingGroup-Nachfolger, für den der Wert der BitmapScalingMode-Eigenschaft festgelegt werden soll.The UIElement or DrawingGroup descendant on which to set the value of the BitmapScalingMode property.

bitmapScalingMode
BitmapScalingMode

Der neue Wert, auf den die Eigenschaft festgelegt werden soll.The new value to set the property to.

Ausnahmen

Der angegebene target ist gleich null.The specified target is null.

Beispiele

Im folgenden Beispiel wird gezeigt, wie das BitmapScalingMode -Objekt Image für ein-Objekt festgelegt wird.The following example shows how to set the BitmapScalingMode for an Image object.

// Set the bitmap scaling mode for the image to render faster.
RenderOptions.SetBitmapScalingMode(MyImage, BitmapScalingMode.LowQuality);
' Set the bitmap scaling mode for the image to render faster.
RenderOptions.SetBitmapScalingMode(MyImage, BitmapScalingMode.LowQuality)

Hinweise

Verwenden Sie SetBitmapScalingMode die-Methode UIElement für DrawingGroup einen-oder-Nachfolger, der eine Bitmap animiert.Use the SetBitmapScalingMode method on a UIElement or DrawingGroup descendant that is animating a bitmap.

Beim Animieren der Skalierung von Bitmaps kann der Standardalgorithmus für das Resampling von Bildern hoher Qualität zuweilen einen solchen Umfang an Systemressourcen beanspruchen, dass eine Verringerung der Einzelbildrate auftritt und Animationen ruckartig wiedergegeben werden.When animating the scale of any bitmap, the default high-quality image re-sampling algorithm can sometimes consume sufficient system resources to cause frame rate degradation, effectively causing animations to stutter. Wenn Sie die BitmapScalingMode -Eigenschaft RenderOptions des-Objekts LowQualityauf festlegen, können Sie beim Skalieren einer Bitmap eine glattere Animation erstellen.By setting the BitmapScalingMode property of the RenderOptions object to LowQuality, you can create a smoother animation when scaling a bitmap.

Gilt für:

Siehe auch