Практическое руководство. Использование элемента изображения
В этом примере показано, как добавлять изображения в приложении с помощью Image элемент.
Пример
В следующем примере показано, как построить изображение шириной 200 пикселей. В этом примере XAML для определения изображения используются как синтаксис атрибута, так и синтаксис тега свойства. Дополнительные сведения о синтаксисе атрибутов и синтаксисе свойств см. в разделе Общие сведения о свойствах зависимостей. Объект BitmapImage используется для определения источника данных изображения и явно определен в примере синтаксиса тега свойства. Кроме того DecodePixelWidth из BitmapImage присваивается такой же ширины, что Width из Image. Это позволяет использовать минимальный объем памяти при построении изображения.
Note
Как правило, если вы хотите указать размер сформированного изображения, укажите только Width или Height , но не оба. Если задано одно значение, пропорции изображения сохраняются. В противном случае изображение может внезапно оказаться растянутым или искривленным. Для управления изображение растяжением, используйте Stretch и StretchDirection свойства.
Note
При указании размера изображения с помощью Width или Height, также необходимо задать либо DecodePixelWidth или DecodePixelHeight на тот же соответствующий размер.
Stretch Свойство определяет, как источник изображения растягивается для заполнения элемента изображения. Дополнительные сведения см. в описании перечисления Stretch.
<!-- Simple image rendering. However, rendering an image this way may not
result in the best use of application memory. See markup below which
creates the same end result but using less memory. -->
<Image Width="200"
Source="C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg"/>
<Image Width="200">
<Image.Source>
<!-- To save significant application memory, set the DecodePixelWidth or
DecodePixelHeight of the BitmapImage value of the image source to the desired
height and 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, only set either DecodePixelWidth
or DecodePixelHeight but not both. -->
<BitmapImage DecodePixelWidth="200"
UriSource="C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg" />
</Image.Source>
</Image>
Пример
В следующем примере показано, как построить изображение шириной 200 пикселей с использованием кода.
Note
Установка BitmapImage свойства должна быть выполнена внутри BeginInit и EndInit блока.
// Create Image Element
Image myImage = new Image();
myImage.Width = 200;
// Create source
BitmapImage myBitmapImage = new BitmapImage();
// BitmapImage.UriSource must be in a BeginInit/EndInit block
myBitmapImage.BeginInit();
myBitmapImage.UriSource = new Uri(@"C:\Documents and Settings\All Users\Documents\My Pictures\Sample Pictures\Water Lilies.jpg");
// 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();
//set image source
myImage.Source = myBitmapImage;