PictureBox (Clase)
Actualización: noviembre 2007
Representa un control de cuadro de imagen de Windows para mostrar una imagen.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
[DockingAttribute(DockingBehavior.Ask)] [ComVisibleAttribute(true)] [DefaultBindingPropertyAttribute("Image")] [ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] public class PictureBox : Control, ISupportInitialize
/** @attribute DockingAttribute(DockingBehavior.Ask) */
/** @attribute ComVisibleAttribute(true) */
/** @attribute DefaultBindingPropertyAttribute("Image") */
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */
public class PictureBox extends Control implements ISupportInitialize
Se suele utilizar el control PictureBox para mostrar gráficos de un archivo de mapa de bits, metarchivo, icono, JPEG, GIF o PNG.
Establezca la propiedad Image en el objeto Image que desea mostrar, ya sea en tiempo de diseño o en tiempo de ejecución. Además, puede especificar la imagen estableciendo la propiedad ImageLocation y cargar la imagen de forma sincrónica utilizando el método Load o de forma asincrónica mediante el método LoadAsync.
Nota:
|
|---|
|
Si desea utilizar la misma imagen en varios controles PictureBox, cree un clon de la imagen para cada control PictureBox. Obtener acceso a la misma imagen desde varios controles hace que se produzca una excepción. |
La propiedad SizeMode, establecida en los valores en la enumeración PictureBoxSizeMode, controla el recorte y la posición de la imagen en el área de presentación. Se puede cambiar el tamaño del área de presentación en tiempo de ejecución con la propiedad ClientSize.
De forma predeterminada, el control PictureBox se muestra sin bordes. Para proporcionar un borde estándar o tridimensional, utilice la propiedad BorderStyle con el fin de distinguir el cuadro de imagen del resto del formulario, incluso si no contiene ninguna imagen. El control PictureBox no se puede seleccionar, lo que significa que no puede recibir el foco de entrada.
En el ejemplo de código siguiente se ilustra cómo se puede establecer una imagen y cambiar el tamaño del área de presentación del cuadro de imagen. En este ejemplo se requiere que se llame a ShowMyImage en un formulario existente y que se haya agregado el espacio de nombres System.Drawing al código fuente del formulario.
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 ; }
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
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.PictureBox
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
