PictureBox, classe

En général, PictureBox est utilisé pour afficher des graphismes issus de fichiers bitmap, icône, JPEG, GIF, PNG ou de métafichiers.

Affectez à la propriété Image l'objet Image à afficher au moment du design ou de l'exécution. Vous pouvez spécifier l'image en définissant la propriété ImageLocation et la charger de façon synchrone à l'aide de la méthode Load ou de façon asynchrone à l'aide de la méthode LoadAsync.

Remarque
Si vous souhaitez utiliser la même image dans plusieurs contrôles PictureBox, créez un clone de l'image pour chaque PictureBox. L'accès à la même image à partir de plusieurs contrôles entraîne le déclenchement d'une exception.

La propriété SizeMode à laquelle sont affectées des valeurs dans l'énumération PictureBoxSizeMode contrôle le découpage et le positionnement de l'image dans la zone d'affichage. Vous pouvez modifier la taille de la zone d'affichage au moment de l'exécution à l'aide de la propriété ClientSize.

Par défaut, le contrôle PictureBox est affiché sans bordure. La propriété BorderStyle vous permet de lui affecter une bordure standard ou 3D qui permettra de distinguer la zone d'image du reste du formulaire même si elle ne contient pas d'image. Le contrôle PictureBox n'est pas sélectionnable, ce qui signifie qu'il ne peut pas recevoir de focus d'entrée.

L'exemple de code suivant montre comment définir une image et redimensionner la zone d'affichage de la zone d'image. Cet exemple requiert l'appel de ShowMyImage dans un formulaire existant et l'ajout de l'espace de noms System.Drawing au code source de votre formulaire.

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 ;
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources