Как задать изображение, отображаемое элементом управления Windows Forms How to: Set the image displayed by a Windows Forms control

Несколько элементов управления Windows Forms могут отображать изображения. Several Windows Forms controls can display images. Эти изображения могут быть значками, поясняющими назначение элемента управления, например значок дискеты на кнопке, обозначающей команду «Сохранить». These images can be icons that clarify the purpose of the control, such as a diskette icon on a button denoting the Save command. Кроме того, значки могут быть фоновыми изображениями, чтобы обеспечить необходимый внешний вид и поведение элемента управления. Alternatively, the icons can be background images to give the control the appearance and behavior you want.

Программный Programmatic

Задайте Image для свойства или элемента управления BackgroundImage объект типа Image . Set the control’s Image or BackgroundImage property to an object of type Image. Как правило, вы загружаете образ из файла с помощью FromFile метода. Generally, you’ll be loading the image from a file by using the FromFile method.

В следующем примере кода путь, заданный для расположения изображения, является папкой » Мои рисунки «. In the following code example, the path set for the location of the image is the My Pictures folder. Большинство компьютеров, работающих под управлением операционной системы Windows, включают этот каталог. Most computers running the Windows operating system include this directory. Это также позволяет пользователям с минимальными уровнями доступа к системе безопасно запускать приложение. This also enables users with minimal system access levels to run the application safely. В следующем примере кода предполагается, что у вас уже есть форма с PictureBox добавленным элементом управления. The following code example requires that you already have a form with a PictureBox control added.

Designer Designer

В окне Свойства в Visual Studio выберите свойство Image или BackgroundImage элемента управления, а затем нажмите кнопку с многоточием ( ), чтобы открыть диалоговое окно Выбор ресурса . In the Properties window of Visual Studio, select the Image or BackgroundImage property of the control, and then select the ellipsis ( ) to display the Select Resource dialog box.

Выберите изображение, которое требуется отобразить. Select the image you want to display.

Практическое руководство. Загрузка изображения с помощью конструктора (Windows Form) How to: Load a Picture Using the Designer (Windows Forms)

С помощью PictureBox элемента управления Windows Forms можно загружать и отображать изображение в форме во время разработки, присвоив Image свойству допустимое изображение. With the Windows Forms PictureBox control, you can load and display a picture on a form at design time by setting the Image property to a valid picture. В следующей таблице приведены допустимые типы файлов. The following table shows the acceptable file types.

Тип Type	Расширение имени файла File name extension
Bitmap Bitmap	BMP .bmp
Значок Icon	ICO .ico
GIF GIF	.gif .gif
Метафайл Metafile	. WMF .wmf
JPEG JPEG	.jpg .jpg

Отображение рисунка во время разработки To display a picture at design time

Рисование PictureBox элемента управления в форме. Draw a PictureBox control on a form.

В окне Свойства выберите Image свойство, а затем нажмите кнопку с многоточием, чтобы открыть диалоговое окно Открытие . In the Properties window, select the Image property, then select the ellipsis button to display the Open dialog box.

Если вы ищете конкретный тип файла (например, GIF-файлы), выберите его в поле файлы типа . If you’re looking for a specific file type (for example, .gif files), select it in the Files of type box.

Выберите файл, который требуется отобразить. Select the file you want to display.

How to display an image on a control (Windows Forms .NET)

Several Windows Forms controls can display images. These images can be icons that clarify the purpose of the control, such as a diskette icon on a button denoting the Save command. Alternatively, the icons can be background images to give the control the appearance and behavior you want.

The Desktop Guide documentation for .NET 5 (and .NET Core) is under construction.

Designer

In the Properties window of Visual Studio, select the Image or BackgroundImage property of the control, and then select the ellipsis ( ) to display the Select Resource dialog box and then select the image you want to display.

Programmatic

Set the control’s Image or BackgroundImage property to an object of type Image. Generally, you’ll be loading the image from a file by using the FromFile method.

In the following code example, the path set for the location of the image is the My Pictures folder. Most computers running the Windows operating system include this directory. This also enables users with minimal system access levels to run the application safely. The following code example requires that you already have a form with a PictureBox control added.

Picture Box. Image Свойство

Определение

Получает или задает изображение, отображаемое элементом управления PictureBox. Gets or sets the image that is displayed by PictureBox.

Значение свойства

Отображаемый объект Image. The Image to display.

Примеры

В следующем примере кода показано, как создать точечный рисунок во время выполнения и отобразить его в, PictureBox установив Image свойство. The following code example demonstrates how to create a bitmap at runtime and display it in a PictureBox by setting the Image property. Чтобы выполнить этот пример, вставьте его в форму Windows Forms и вызовите CreateBitmapAtRuntime из конструктора формы. To run this example, paste it into a Windows Form and call CreateBitmapAtRuntime from the form’s constructor.

Комментарии

Для отображения свойству Image задается Image. The Image property is set to the Image to display. Это можно сделать либо во время разработки, либо во время выполнения. You can do this either at design time or at run time.

Если вы хотите использовать одно и то же изображение в нескольких PictureBox элементах управления, создайте клон изображения для каждого из них PictureBox . If you want to use the same image in multiple PictureBox controls, create a clone of the image for each PictureBox. Доступ к тому же изображению из нескольких элементов управления приводит к возникновению исключения. Accessing the same image from multiple controls causes an exception to occur.

Практическое руководство. Установка изображений во время выполнения (Windows Forms) How to: Set Pictures at Run Time (Windows Forms)

Можно программно задать изображение, отображаемое Windows Formsным PictureBox элементом управления. You can programmatically set the image displayed by a Windows Forms PictureBox control.

Установка рисунка программным способом To set a picture programmatically

Задайте Image свойство с помощью FromFile метода Image класса. Set the Image property using the FromFile method of the Image class.

В приведенном ниже примере путь, заданный для расположения изображения, является папкой «Мои документы». In the example below, the path set for the location of the image is the My Documents folder. Это делается, поскольку можно предположить, что большинство компьютеров, работающих под управлением операционной системы Windows, будут включать этот каталог. This is done, because you can assume that most computers running the Windows operating system will include this directory. Это также позволяет пользователям с минимальным уровнем доступа к системе безопасно запускать приложение. This also allows users with minimal system access levels to safely run the application. В приведенном ниже примере предполагается, что форма с PictureBox уже добавленным элементом управления. The example below assumes a form with a PictureBox control already added.

Очистка графического изображения To clear a graphic

Сначала освободите память, используемую изображением, а затем очистите изображение. First, release the memory being used by the image, and then clear the graphic. Если управление памятью становится проблемой, сборка мусора освободит память позже. Garbage collection will free up the memory later if memory management becomes a problem.

Дополнительные сведения о том, почему следует использовать Dispose метод таким образом, см. в разделе Очистка неуправляемых ресурсов. For more information on why you should use the Dispose method in this way, see Cleaning Up Unmanaged Resources.

Этот код очистит изображение, даже если изображение было загружено в элемент управления во время разработки. This code will clear the image even if a graphic was loaded into the control at design time.