FormatConvertedBitmap.EndInit Méthode

Définition

Espace de noms:

System.Windows.Media.Imaging

Assembly:

PresentationCore.dll

Signale la fin de l'initialisation de FormatConvertedBitmap.

C#

[System.Security.SecurityCritical]
public void EndInit ();

C#

public void EndInit ();

Implémente

EndInit()

Attributs

SecurityCriticalAttribute

Exceptions

InvalidOperationException

La propriété Source a la valeur null.

• ou - La propriété DestinationFormat est un format indexé et la propriété DestinationPalette est null.

• ou - Les couleurs de la palette ne correspondent pas au format de destination.

• ou - La méthode EndInit() est appelée sans préalablement appeler BeginInit().

Exemples

L’exemple suivant montre comment initialiser un FormatConvertedBitmap ensemble de propriétés à l’aide des méthodes et EndInit des BeginInit méthodes.

C#

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Media.Imaging;

namespace SDKSample
{
    public partial class FormatConvertedBitmapExample : Page
    {
        public FormatConvertedBitmapExample()
        {

            ///// Create a BitmapImage and set it's DecodePixelWidth to 200. Use  /////
            ///// this BitmapImage as a source for other BitmapSource objects.    /////

            BitmapImage myBitmapImage = new BitmapImage();

            // BitmapSource objects like BitmapImage can only have their properties
            // changed within a BeginInit/EndInit block.
            myBitmapImage.BeginInit();
            myBitmapImage.UriSource = new Uri(@"sampleImages/WaterLilies.jpg",UriKind.Relative);

            // To save significant application memory, set the DecodePixelWidth or  
            // DecodePixelHeight of the BitmapImage value of the image source to the desired 
            // height or width of the rendered image. If you don't do this, the application will 
            // cache the image as though it were rendered as its normal size rather then just 
            // the size that is displayed.
            // Note: In order to preserve aspect ratio, set DecodePixelWidth
            // or DecodePixelHeight but not both.
            myBitmapImage.DecodePixelWidth = 200;
            myBitmapImage.EndInit();

            ////////// Convert the BitmapSource to a new format ////////////
            // Use the BitmapImage created above as the source for a new BitmapSource object
            // which is set to a gray scale format using the FormatConvertedBitmap BitmapSource.                                               
            // Note: New BitmapSource does not cache. It is always pulled when required.

            FormatConvertedBitmap newFormatedBitmapSource = new FormatConvertedBitmap();

            // BitmapSource objects like FormatConvertedBitmap can only have their properties
            // changed within a BeginInit/EndInit block.
            newFormatedBitmapSource.BeginInit();

            // Use the BitmapSource object defined above as the source for this new 
            // BitmapSource (chain the BitmapSource objects together).
            newFormatedBitmapSource.Source = myBitmapImage;

            // Set the new format to Gray32Float (grayscale).
            newFormatedBitmapSource.DestinationFormat = PixelFormats.Gray32Float;
            newFormatedBitmapSource.EndInit();

            // Create Image Element
            Image myImage = new Image();
            myImage.Width = 200;
            //set image source
            myImage.Source = newFormatedBitmapSource;

            // Add Image to the UI
            StackPanel myStackPanel = new StackPanel();
            myStackPanel.Children.Add(myImage);
            this.Content = myStackPanel;
        }
    }
}

Remarques

L’initialisation de propriété doit être effectuée entre BeginInit et EndInit les appels, comme illustré dans l’exemple suivant. Une fois l’initialisation FormatConvertedBitmap effectuée, les modifications de propriété sont ignorées.

S’applique à

Voir aussi

• BeginInit()
• ISupportInitialize