Image.FromFile Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria um Image do arquivo especificado.
Sobrecargas
FromFile(String) |
Cria um Image do arquivo especificado. |
FromFile(String, Boolean) |
Cria um Image do arquivo especificado usando informações de gerenciamento de cores inseridas nesse arquivo. |
FromFile(String)
- Origem:
- Image.cs
- Origem:
- Image.cs
- Origem:
- Image.cs
- Origem:
- Image.cs
- Origem:
- Image.cs
Cria um Image do arquivo especificado.
public:
static System::Drawing::Image ^ FromFile(System::String ^ filename);
public static System.Drawing.Image FromFile (string filename);
static member FromFile : string -> System.Drawing.Image
Public Shared Function FromFile (filename As String) As Image
Parâmetros
Retornos
O Image que esse método cria.
Exceções
O arquivo não tem um formato de imagem válido.
-ou-
O GDI+ não dá suporte ao formato de pixel do arquivo.
O arquivo especificado não existe.
filename
é um Uri.
Exemplos
O exemplo de código a seguir demonstra como usar os métodos FromFileGetPropertyItem e SetPropertyItem. Este exemplo foi projetado para ser usado com o Windows Forms. Para executar este exemplo, cole-o em um formulário e manipule o evento Paint do formulário chamando o método DemonstratePropertyItem
, passando e
como PaintEventArgs.
private:
void DemonstratePropertyItem( PaintEventArgs^ e )
{
// Create two images.
Image^ image1 = Image::FromFile( "c:\\FakePhoto1.jpg" );
Image^ image2 = Image::FromFile( "c:\\FakePhoto2.jpg" );
// Get a PropertyItem from image1.
PropertyItem^ propItem = image1->GetPropertyItem( 20624 );
// Change the ID of the PropertyItem.
propItem->Id = 20625;
// Set the PropertyItem for image2.
image2->SetPropertyItem( propItem );
// Draw the image.
e->Graphics->DrawImage( image2, 20.0F, 20.0F );
}
private void DemonstratePropertyItem(PaintEventArgs e)
{
// Create two images.
Image image1 = Image.FromFile("c:\\FakePhoto1.jpg");
Image image2 = Image.FromFile("c:\\FakePhoto2.jpg");
// Get a PropertyItem from image1.
PropertyItem propItem = image1.GetPropertyItem(20624);
// Change the ID of the PropertyItem.
propItem.Id = 20625;
// Set the PropertyItem for image2.
image2.SetPropertyItem(propItem);
// Draw the image.
e.Graphics.DrawImage(image2, 20.0F, 20.0F);
}
Private Sub DemonstratePropertyItem(ByVal e As PaintEventArgs)
' Create two images.
Dim image1 As Image = Image.FromFile("c:\FakePhoto1.jpg")
Dim image2 As Image = Image.FromFile("c:\FakePhoto2.jpg")
' Get a PropertyItem from image1.
Dim propItem As PropertyItem = image1.GetPropertyItem(20624)
' Change the ID of the PropertyItem.
propItem.Id = 20625
' Set the PropertyItem for image2.
image2.SetPropertyItem(propItem)
' Draw the image.
e.Graphics.DrawImage(image2, 20.0F, 20.0F)
End Sub
Comentários
O GDI+ gerenciado tem codificadores internos e decodificadores que dão suporte aos seguintes tipos de arquivo:
BMP
GIF
JPEG
PNG
TIFF
O arquivo permanece bloqueado até que o Image seja descartado.
Se o arquivo não tiver um formato de imagem válido ou se GDI+ não der suporte ao formato de pixel do arquivo, esse método gerará uma exceção OutOfMemoryException.
Nota
A classe Image não dá suporte à transparência alfa em bitmaps. Para habilitar a transparência alfa, use imagens PNG com 32 bits por pixel.
Confira também
Aplica-se a
FromFile(String, Boolean)
- Origem:
- Image.cs
- Origem:
- Image.cs
- Origem:
- Image.cs
- Origem:
- Image.cs
- Origem:
- Image.cs
Cria um Image do arquivo especificado usando informações de gerenciamento de cores inseridas nesse arquivo.
public:
static System::Drawing::Image ^ FromFile(System::String ^ filename, bool useEmbeddedColorManagement);
public static System.Drawing.Image FromFile (string filename, bool useEmbeddedColorManagement);
static member FromFile : string * bool -> System.Drawing.Image
Public Shared Function FromFile (filename As String, useEmbeddedColorManagement As Boolean) As Image
Parâmetros
- useEmbeddedColorManagement
- Boolean
Definir como true
para usar informações de gerenciamento de cores inseridas no arquivo de imagem; caso contrário, false
.
Retornos
O Image que esse método cria.
Exceções
O arquivo não tem um formato de imagem válido.
-ou-
O GDI+ não dá suporte ao formato de pixel do arquivo.
O arquivo especificado não existe.
filename
é um Uri.
Exemplos
O exemplo de código a seguir demonstra como obter um novo bitmap usando o método FromFile. Ele também demonstra um TextureBrush.
Este exemplo foi projetado para ser usado com o Windows Forms. Crie um formulário que contenha um botão chamado Button2
. Cole o código no formulário e associe o método Button2_Click
ao evento Click do botão.
private:
void Button2_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
try
{
Bitmap^ image1 = dynamic_cast<Bitmap^>(Image::FromFile( "C:\\Documents and Settings\\"
"All Users\\Documents\\My Music\\music.bmp", true ));
TextureBrush^ texture = gcnew TextureBrush( image1 );
texture->WrapMode = System::Drawing::Drawing2D::WrapMode::Tile;
Graphics^ formGraphics = this->CreateGraphics();
formGraphics->FillEllipse( texture, RectangleF(90.0F,110.0F,100,100) );
delete formGraphics;
}
catch ( System::IO::FileNotFoundException^ )
{
MessageBox::Show( "There was an error opening the bitmap."
"Please check the path." );
}
}
private void Button2_Click(System.Object sender, System.EventArgs e)
{
try
{
Bitmap image1 = (Bitmap) Image.FromFile(@"C:\Documents and Settings\" +
@"All Users\Documents\My Music\music.bmp", true);
TextureBrush texture = new TextureBrush(image1);
texture.WrapMode = System.Drawing.Drawing2D.WrapMode.Tile;
Graphics formGraphics = this.CreateGraphics();
formGraphics.FillEllipse(texture,
new RectangleF(90.0F, 110.0F, 100, 100));
formGraphics.Dispose();
}
catch(System.IO.FileNotFoundException)
{
MessageBox.Show("There was an error opening the bitmap." +
"Please check the path.");
}
}
Private Sub Button2_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button2.Click
Try
Dim image1 As Bitmap = _
CType(Image.FromFile("C:\Documents and Settings\" _
& "All Users\Documents\My Music\music.bmp", True), Bitmap)
Dim texture As New TextureBrush(image1)
texture.WrapMode = Drawing2D.WrapMode.Tile
Dim formGraphics As Graphics = Me.CreateGraphics()
formGraphics.FillEllipse(texture, _
New RectangleF(90.0F, 110.0F, 100, 100))
formGraphics.Dispose()
Catch ex As System.IO.FileNotFoundException
MessageBox.Show("There was an error opening the bitmap." _
& "Please check the path.")
End Try
End Sub
Comentários
O GDI+ gerenciado tem codificadores internos e decodificadores que dão suporte aos seguintes tipos de arquivo:
BMP
GIF
JPEG
PNG
TIFF
Se o arquivo não tiver um formato de imagem válido ou se GDI+ não der suporte ao formato de pixel do arquivo, esse método gerará uma exceção OutOfMemoryException.
O arquivo permanece bloqueado até que o Image seja descartado.
O parâmetro useEmbeddedColorManagement
especifica se o novo Image aplica a correção de cor de acordo com as informações de gerenciamento de cores inseridas no arquivo de imagem. As informações inseridas podem incluir perfis do ICC (International Color Consortium), valores gama e informações de cromática.
Nota
A classe Image não dá suporte à transparência alfa em bitmaps. Para habilitar a transparência alfa, use imagens PNG com 32 bits por pixel.