Control.BackgroundImage Propiedad

Definición

Obtiene o establece la imagen de fondo que se muestra en el control.Gets or sets the background image displayed in the 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; }
member this.BackgroundImage : System.Drawing.Image with get, set
Public Overridable Property BackgroundImage As Image

Valor de propiedad

Image que representa la imagen que se va a mostrar en el fondo del control.An Image that represents the image to display in the background of the control.

Ejemplos

En el ejemplo de código siguiente se agrega un Button a un formulario y se establecen algunas de sus propiedades comunes.The following code example adds a Button to a form and sets some of its common properties. En el ejemplo se delimita el botón en la esquina inferior derecha del formulario para que mantenga su posición relativa a medida que se cambia el tamaño del formulario.The example anchors the button to the bottom-right corner of the form so it keeps its relative position as the form is resized. A continuación, establece el BackgroundImage y cambia el tamaño del botón al mismo tamaño que el Image.Next it sets the BackgroundImage and resizes the button to the same size as the Image. A continuación, en el ejemplo se establece el TabStop en true y se establece la propiedad TabIndex.The example then sets the TabStop to true and sets the TabIndex property. Por último, agrega un controlador de eventos para controlar el evento Click del botón.Lastly, it adds an event handler to handle the Click event of the button. Este ejemplo requiere que tenga un ImageList denominado imageList1.This example requires that you have an ImageList named 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

  • Use la propiedad BackgroundImage para colocar una imagen gráfica en un control.Use the BackgroundImage property to place a graphic image onto a control.

Nota

Los controles de Windows Forms no admiten imágenes con colores translúcido o transparentes como imágenes de fondo.Images with translucent or transparent colors are not supported by Windows Forms controls as background images.

Esta propiedad no se admite en los controles secundarios cuya propiedad RightToLeftLayout sea true.This property is not supported on child controls whose RightToLeftLayout property is true.

Notas a los desarrolladores de herederos

Al reemplazar la propiedad BackgroundImage en una clase derivada, use la propiedad BackgroundImage de la clase base para extender la implementación base.When overriding the BackgroundImage property in a derived class, use the base class's BackgroundImage property to extend the base implementation. De lo contrario, debe proporcionar toda la implementación.Otherwise, you must provide all the implementation. No es necesario reemplazar los descriptores de acceso get y set de la propiedad BackgroundImage; solo puede invalidar una si es necesario.You are not required to override both the get and set accessors of the BackgroundImage property; you can override only one if needed.

Se aplica a

Consulte también: