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