PictureBox-Klasse

Stellt ein Windows-Bildfeld-Steuerelement für die Anzeige eines Bildes dar.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class PictureBox
    Inherits Control
    Implements ISupportInitialize
'Usage
Dim instance As PictureBox

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class PictureBox : Control, ISupportInitialize

[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class PictureBox : public Control, ISupportInitialize

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class PictureBox extends Control implements ISupportInitialize

ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class PictureBox extends Control implements ISupportInitialize

Hinweise

Grafiken aus Bitmap-, Symbol-, JPEG-, GIF- oder PNG-Dateien werden üblicherweise mithilfe der PictureBox angezeigt.

Legen Sie die Image-Eigenschaft entweder zur Entwurfszeit oder zur Laufzeit auf das anzuzeigende Image fest. Sie können das Bild auch über die ImageLocation-Eigenschaft angeben und synchron mithilfe der Load-Methode oder asynchron mithilfe der LoadAsync-Methode laden. Das Ausschneiden (Clipping) und die Positionierung des Bildes im Anzeigebereich werden über die SizeMode-Eigenschaft gesteuert, die auf Werte in der PictureBoxSizeMode-Enumeration festgelegt ist. Mithilfe der ClientSize-Eigenschaft können Sie die Größe des Anzeigebereichs zur Laufzeit ändern.

Das PictureBox-Steuerelement wird standardmäßig ohne Rahmen angezeigt. Mithilfe der BorderStyle-Eigenschaft können Sie einen Standardrahmen oder einen dreidimensionalen Rahmen bereitstellen, um das Bildfeld vom Rest des Formulars abzuheben, auch wenn es kein Bild enthält. Die PictureBox ist kein auswählbares Steuerelement und kann folglich den Eingabefokus nicht erhalten.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein Bild festlegen und die Größe des Anzeigebereichs des Bildfelds ändern können. In diesem Beispiel wird davon ausgegangen, dass ShowMyImage aus einem vorhandenen Formular aufgerufen wird und der System.Drawing-Namespace dem Quellcode des Formulars hinzugefügt wurde.

Private MyImage As Bitmap
   
Public Sub ShowMyImage(fileToDisplay As String, xSize As Integer, _
                       ySize As Integer)
    ' Sets up an image object to be displayed.
    If (MyImage IsNot Nothing) Then
        MyImage.Dispose()
    End If
       
    ' Stretches the image to fit the pictureBox. 
    pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage
    MyImage = New Bitmap(fileToDisplay)
    pictureBox1.ClientSize = New Size(xSize, ySize)
    pictureBox1.Image = CType(MyImage, Image)
End Sub

private Bitmap MyImage ;
public void ShowMyImage(String fileToDisplay, int xSize, int ySize)
{
   // Sets up an image object to be displayed.
   if (MyImage != null)
   {
      MyImage.Dispose();
   }

   // Stretches the image to fit the pictureBox.
   pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage ;
   MyImage = new Bitmap(fileToDisplay);
   pictureBox1.ClientSize = new Size(xSize, ySize);
   pictureBox1.Image = (Image) MyImage ;
}

   Bitmap^ MyImage;

public:
   void ShowMyImage( String^ fileToDisplay, int xSize, int ySize )
   {
      
      // Sets up an image object to be displayed.
      if ( MyImage != nullptr )
      {
         delete MyImage;
      }

      
      // Stretches the image to fit the pictureBox.
      pictureBox1->SizeMode = PictureBoxSizeMode::StretchImage;
      MyImage = gcnew Bitmap( fileToDisplay );
      pictureBox1->ClientSize = System::Drawing::Size( xSize, ySize );
      pictureBox1->Image = dynamic_cast<Image^>(MyImage);
   }

private Bitmap myImage;
public void ShowMyImage(String fileToDisplay, int xSize, int ySize)
{
    // Sets up an image object to be displayed.
    if (myImage != null) {
        myImage.Dispose();
    }

    // Stretches the image to fit the pictureBox.
    pictureBox1.set_SizeMode(PictureBoxSizeMode.StretchImage);
    myImage = new Bitmap(fileToDisplay);
    pictureBox1.set_ClientSize(new Size(xSize, ySize));
    pictureBox1.set_Image(myImage);
} //ShowMyImage

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Windows.Forms.Control
        System.Windows.Forms.PictureBox

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

PictureBox-Member
System.Windows.Forms-Namespace