Gewusst wie: Ändern der Größe oder Platzierung eines Bildes zur Laufzeit (Windows Forms)

Aktualisiert: November 2007

Wenn Sie das Windows Forms-Steuerelement PictureBox auf einem Formular verwenden, können Sie die SizeMode-Eigenschaft wie folgt festlegen:

• Die obere linke Bildecke wird auf die obere linke Ecke des Steuerelements ausgerichtet.

• Das Bild wird innerhalb des Steuerelements zentriert.

• Die Größe des Steuerelements wird an die Größe des Bildes angepasst.

• Das Bild wird in Anpassung an die Größe des jeweiligen Steuerelements gedehnt.

Durch das Dehnen von Bildern kann die Bildqualität (besonders bei Verwendung des Bitmap-Formats) gemindert werden. Metadateien sind besser für das Dehnen von Bildern geeignet, da sie aus einer Auflistung von Grafikanweisungen bestehen, die das Bild während der Laufzeit aufbauen.

So legen Sie die SizeMode-Eigenschaft zur Laufzeit fest

• Legen Sie SizeMode auf Normal (der Standardwert), AutoSize, CenterImage oder StretchImage fest. Normal bedeutet, dass das Bild in der linken oberen Ecke des Steuerelements platziert wird. Wenn das Bild größer als das Steuerelement ist, werden sein unterer und rechter Rand abgeschnitten. CenterImage bedeutet, dass das Bild im Steuerelement zentriert wird. Wenn das Bild größer als das Steuerelement ist, werden die äußeren Ränder des Bilds abgeschnitten. AutoSize bedeutet, dass die Größe des Steuerelements an die Größe des Bildes angepasst wird. StretchImage bedeutet das Gegenteil, nämlich dass die Größe des Bildes an die Größe des Steuerelements angepasst wird.

  Im unten stehenden Beispiel wurde als Speicherort für das Bild der Ordner Eigene Dateien festgelegt. Dieser Speicherort wird verwendet, weil vorausgesetzt werden kann, dass die meisten Computer mit einem Windows-Betriebssystem über dieses Verzeichnis verfügen. Dieser Speicherort ermöglicht es auch Benutzern mit minimalen Systemzugriffsberechtigungen, die Anwendung sicher auszuführen. Im unten stehenden Beispiel wird davon ausgegangen, dass einem Formular bereits ein PictureBox-Steuerelement hinzugefügt wurde.

  Private Sub StretchPic()
     ' Stretch the picture to fit the control.
     PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage
     ' Load the picture into the control.
     ' 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 StretchPic(){
     // Stretch the picture to fit the control.
     PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
     // Load the picture into the control.
     // 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 StretchPic(){
     // Stretch the picture to fit the control.
     pictureBox1.set_SizeMode(PictureBoxSizeMode.StretchImage);
     // Load the picture into the control.
     // You should replace "image.gif" in the sample below 
     // with an icon of your own choosing.
     pictureBox1.set_Image(Image.FromFile
     (System.Environment.GetFolderPath
     (System.Environment.SpecialFolder.Personal)
     + "\\Image.gif"));
  }
  
  private:
     void StretchPic()
     {
        // Stretch the picture to fit the control.
        pictureBox1->SizeMode = PictureBoxSizeMode::StretchImage;
        // Load the picture into the control.
        // 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"));
     }
  

Siehe auch

Aufgaben

Gewusst wie: Laden eines Bilds mithilfe des Designers (Windows Forms)

Gewusst wie: Festlegen von Bildern zur Laufzeit (Windows Forms)

Referenz

PictureBox

Übersicht über das PictureBox-Steuerelement (Windows Forms)

Weitere Ressourcen

PictureBox-Steuerelement (Windows Forms)