Graphics.FromImage(Image) Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Исходный код:

Graphics.cs

Создает новый объект Graphics из указанного объекта Image.

public:
 static System::Drawing::Graphics ^ FromImage(System::Drawing::Image ^ image);

public static System.Drawing.Graphics FromImage (System.Drawing.Image image);

static member FromImage : System.Drawing.Image -> System.Drawing.Graphics

Public Shared Function FromImage (image As Image) As Graphics

Параметры

image

Image

Объект Image, на основе которого будет создан новый объект Graphics.

Возвращаемое значение

Graphics

Этот метод возвращает новый объект Graphics для указанного объекта Image.

Исключения

ArgumentNullException

image имеет значение null.

Exception

Объект image имеет индексированный формат пикселей или его формат не определен.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse, который является параметром обработчика Paint событий. Код выполняет следующее действие:

• Создает из Image графического файла SampImag.jpg в папке примера.

• Создает из GraphicsImage.

• Изменяет изображение, заполняя прямоугольник внутри него.

• Рисует на Image экране.

• Освобождает созданный Graphicsобъект .

public:
   void FromImageImage( PaintEventArgs^ e )
   {
      // Create image.
      Image^ imageFile = Image::FromFile( "SampImag.jpg" );

      // Create graphics object for alteration.
      Graphics^ newGraphics = Graphics::FromImage( imageFile );

      // Alter image.
      newGraphics->FillRectangle( gcnew SolidBrush( Color::Black ), 100, 50, 100, 100 );

      // Draw image to screen.
      e->Graphics->DrawImage( imageFile, PointF(0.0F,0.0F) );

      // Dispose of graphics object.
      delete newGraphics;
   }

private void FromImageImage(PaintEventArgs e)
{

    // Create image.
    Image imageFile = Image.FromFile("SampImag.jpg");

    // Create graphics object for alteration.
    Graphics newGraphics = Graphics.FromImage(imageFile);

    // Alter image.
    newGraphics.FillRectangle(new SolidBrush(Color.Black), 100, 50, 100, 100);

    // Draw image to screen.
    e.Graphics.DrawImage(imageFile, new PointF(0.0F, 0.0F));

    // Dispose of graphics object.
    newGraphics.Dispose();
}

Private Sub FromImageImage2(ByVal e As PaintEventArgs)

    ' Create image.
    Dim imageFile As Image = Image.FromFile("SampImag.jpg")

    ' Create graphics object for alteration.
    Dim newGraphics As Graphics = Graphics.FromImage(imageFile)

    ' Alter image.
    newGraphics.FillRectangle(New SolidBrush(Color.Black), _
    100, 50, 100, 100)

    ' Draw image to screen.
    e.Graphics.DrawImage(imageFile, New PointF(0.0F, 0.0F))

    ' Dispose of graphics object.
    newGraphics.Dispose()
End Sub

Комментарии

Если изображение имеет индексированный формат пикселей, этот метод создает исключение с сообщением "Не удается создать графический объект из изображения с индексированных пикселей". Форматы индексированных пикселей показаны в следующем списке.

• Format1bppIndexed

• Format4bppIndexed

• Format8bppIndexed

Можно сохранить индексируемое изображение в другом формате с помощью Save(String, ImageFormat) метода , а затем получить Graphics объект для нового изображения.

Этот метод также создает исключение, если изображение имеет любой из следующих форматов пикселей.

• Undefined

• DontCare

• Format16bppArgb1555

• Format16bppGrayScale

Всегда следует вызывать метод , Dispose чтобы освободить Graphics и связанные ресурсы, созданные методом FromImage .

См. также раздел

• Практическое руководство. Создание растрового изображения во время выполнения
• Работа с растровыми и векторными изображениями
• Практическое руководство. Создание графических объектов для рисования