Cómo: Establecer imágenes en tiempo de ejecución (formularios Windows Forms)

Actualización: noviembre 2007

Puede establecer, mediante programación, la imagen que muestra un control PictureBox de un formulario Windows Forms.

Para establecer una imagen mediante programación

• Establezca la propiedad Image mediante el método FromFile de la clase Image.

  En el ejemplo siguiente, la ruta de acceso establecida para la ubicación de la imagen es la carpeta Mis documentos (My Documents). Se utiliza esta ubicación porque se puede asumir que la mayoría de los equipos que ejecuten el sistema operativo Windows tendrán este directorio. Esto permite también a los usuarios con niveles de acceso mínimos ejecutar la aplicación de un modo seguro. En el ejemplo siguiente suponemos que ya se ha agregado un control PictureBox al formulario.

  Private Sub LoadNewPict()
     ' You should replace the bold image 
     ' in the sample below with an icon of your own choosing.
     PictureBox1.Image = Image.FromFile _
     (System.Environment.GetFolderPath _
     (System.Environment.SpecialFolder.Personal) _
     & "\Image.gif")
  End Sub
  

  private void LoadNewPict(){
     // You should replace the bold image 
     // in the sample below with an icon of your own choosing.
     // Note the escape character used (@) when specifying the path.
     pictureBox1.Image = Image.FromFile
     (System.Environment.GetFolderPath
     (System.Environment.SpecialFolder.Personal)
     + @"\Image.gif");
  }
  

  private void LoadNewPict(){
     // You should replace the bold image 
     // in the sample below with an icon of your own choosing.
     pictureBox1.get_Image().FromFile
     (System.Environment.GetFolderPath
     (System.Environment.SpecialFolder.Personal)
     + "\\Image.gif");
  

  private:
     void LoadNewPict()
     {
        // You should replace the bold image 
        // in the sample below with an icon of your own choosing.
        pictureBox1->Image = Image::FromFile(String::Concat(
           System::Environment::GetFolderPath(
           System::Environment::SpecialFolder::Personal),
           "\\Image.gif"));
     }
  

Para borrar un gráfico

• En primer lugar, libere la memoria que utiliza la imagen y borre el gráfico. La recolección de elementos no utilizados liberará la memoria más adelante si la administración de la memoria se convierte en un problema.

  If Not (PictureBox1.Image Is Nothing) Then
     PictureBox1.Image.Dispose()
     PictureBox1.Image = Nothing
  End If
  

  if (pictureBox1.Image != null) 
  {
     pictureBox1.Image.Dispose();
     pictureBox1.Image = null;
  }
  

  if (pictureBox1->Image != nullptr)
  {
     pictureBox1->Image->Dispose();
     pictureBox1->Image = nullptr;
  }
  

  Nota:
  Para obtener más información sobre por qué debe utilizar el método Dispose de esta manera, vea Limpiar recursos no administrados.

  Este código borrará la imagen aunque se haya cargado un gráfico en el control en tiempo de diseño.

Vea también

Tareas

Cómo: Cargar una imagen mediante el Diseñador (formularios Windows Forms)

Cómo: Modificar el tamaño o la situación de una imagen en tiempo de ejecución (formularios Windows Forms)

Referencia

Información general del control PictureBox (Formularios Windows Forms)

PictureBox

Image.FromFile

Otros recursos

PictureBox (Control, formularios Windows Forms)