Control.BackgroundImage Propiedad

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Source:: Control.cs

Source:: Control.cs

Source:: Control.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece la imagen de fondo que se muestra en el control.

public:
 virtual property System::Drawing::Image ^ BackgroundImage { System::Drawing::Image ^ get(); void set(System::Drawing::Image ^ value); };

public virtual System.Drawing.Image BackgroundImage { get; set; }

public virtual System.Drawing.Image? BackgroundImage { get; set; }

member this.BackgroundImage : System.Drawing.Image with get, set

Public Overridable Property BackgroundImage As Image

Valor de propiedad

Image

Image que representa la imagen que se va a mostrar en el fondo del control.

Ejemplos

En el ejemplo de código siguiente se agrega un Button objeto a un formulario y se establecen algunas de sus propiedades comunes. En el ejemplo se ancla el botón a la esquina inferior derecha del formulario para que mantenga su posición relativa a medida que se cambia el tamaño del formulario. A continuación, establece y BackgroundImage cambia el tamaño del botón al mismo tamaño que .Image A continuación, el ejemplo establece en TabStoptrue y establece la TabIndex propiedad . Por último, agrega un controlador de eventos para controlar el Click evento del botón. En este ejemplo se requiere que tenga un ImageList denominado imageList1.

   // Add a button to a form and set some of its common properties.
private:
   void AddMyButton()
   {
      // Create a button and add it to the form.
      Button^ button1 = gcnew Button;

      // Anchor the button to the bottom right corner of the form
      button1->Anchor = static_cast<AnchorStyles>(AnchorStyles::Bottom | AnchorStyles::Right);

      // Assign a background image.
      button1->BackgroundImage = imageList1->Images[ 0 ];

      // Specify the layout style of the background image. Tile is the default.
      button1->BackgroundImageLayout = ImageLayout::Center;

      // Make the button the same size as the image.
      button1->Size = button1->BackgroundImage->Size;

      // Set the button's TabIndex and TabStop properties.
      button1->TabIndex = 1;
      button1->TabStop = true;

      // Add a delegate to handle the Click event.
      button1->Click += gcnew System::EventHandler( this, &Form1::button1_Click );

      // Add the button to the form.
      this->Controls->Add( button1 );
   }

// Add a button to a form and set some of its common properties.
private void AddMyButton()
{
   // Create a button and add it to the form.
   Button button1 = new Button();

   // Anchor the button to the bottom right corner of the form
   button1.Anchor = (AnchorStyles.Bottom | AnchorStyles.Right);

   // Assign a background image.
   button1.BackgroundImage = imageList1.Images[0];

   // Specify the layout style of the background image. Tile is the default.
   button1.BackgroundImageLayout = ImageLayout.Center;
   
   // Make the button the same size as the image.
   button1.Size = button1.BackgroundImage.Size;

   // Set the button's TabIndex and TabStop properties.
   button1.TabIndex = 1;
   button1.TabStop = true;

   // Add a delegate to handle the Click event.
   button1.Click += new System.EventHandler(this.button1_Click);

   // Add the button to the form.
   this.Controls.Add(button1);
}

' Add a button to a form and set some of its common properties.
Private Sub AddMyButton()
   ' Create a button and add it to the form.
   Dim button1 As New Button()
   
   ' Anchor the button to the bottom right corner of the form
   button1.Anchor = AnchorStyles.Bottom Or AnchorStyles.Right
   
   ' Assign a background image.
   button1.BackgroundImage = imageList1.Images(0)

   ' Specify the layout style of the background image. Tile is the default.
   button1.BackgroundImageLayout = ImageLayout.Center
   
   ' Make the button the same size as the image.
   button1.Size = button1.BackgroundImage.Size
   
   ' Set the button's TabIndex and TabStop properties.
   button1.TabIndex = 1
   button1.TabStop = True

   ' Add a delegate to handle the Click event.
   AddHandler button1.Click, AddressOf Me.button1_Click
   
   ' Add the button to the form.
   Me.Controls.Add(button1)
End Sub

Comentarios

Utilice la BackgroundImage propiedad para colocar una imagen gráfica en un control.

Nota

Las imágenes con colores transparentes o translúcidos no son compatibles con los controles de Windows Forms como imágenes de fondo.

Esta propiedad no se admite en los controles secundarios cuya RightToLeftLayout propiedad es true.

Notas a los desarrolladores de herederos

Al invalidar la BackgroundImage propiedad en una clase derivada, use la propiedad de BackgroundImage la clase base para ampliar la implementación base. De lo contrario, debe proporcionar toda la implementación. No es necesario invalidar los get descriptores de acceso y set de la BackgroundImage propiedad; solo puede invalidar uno si es necesario.

Se aplica a

Producto	Versiones
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Compartir a través de