Actualización: noviembre 2007
Especifica si el tamaño de la imagen de un ToolStripItem se ajusta automáticamente y cabe en un ToolStrip, al tiempo que se conservan las proporciones originales de la imagen.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
Public Enumeration ToolStripItemImageScaling
Dim instance As ToolStripItemImageScaling
public enum ToolStripItemImageScaling
public enum class ToolStripItemImageScaling
public enum ToolStripItemImageScaling
public enum ToolStripItemImageScaling
| Nombre de miembro | Descripción | |
|---|---|---|
| None | Especifica que el tamaño de la imagen de un ToolStripItem no se ajusta automáticamente para caber en un ToolStrip. | |
| SizeToFit | Especifica que el tamaño de la imagen de un ToolStripItem se ajusta automáticamente y cabe en un ToolStrip. |
Las propiedades Image, ImageAlign, ImageIndex, ImageKey y ImageScaling conciernen a diversos aspectos del control de imágenes. Utilice imágenes en los controles ToolStrip estableciendo estas propiedades directamente o la propiedad ImageList únicamente en tiempo de ejecución.
El ajuste de escala de imágenes está determinado por la interacción de propiedades en ToolStrip y en ToolStripItem, del siguiente modo:
-
ImageScalingSize es la escala de la imagen final, según determina la combinación del valor de ImageScaling de la imagen y el valor de AutoSize del contenedor.
-
Si AutoSize es true (valor predeterminado) y ToolStripItemImageScaling es SizeToFit, no se ajustará la escala de las imágenes, y el tamaño de ToolStrip será el del elemento de mayor tamaño o el tamaño mínimo prescrito.
-
Si AutoSize es false y ToolStripItemImageScaling es None, no se producirá ninguna imagen ni ajuste de escala de ToolStrip.
-
Para controlar el tamaño de la imagen, utilice la propiedad ImageScalingSize.
En el ejemplo de código siguiente se aplica el miembro SizeToFit a un ToolStripButton.
Friend WithEvents imageButton As ToolStripButton Private Sub InitializeImageButtonWithToolTip() ' Construct the button and set the image-related properties. imageButton = New ToolStripButton() imageButton.Image = New Bitmap(GetType(Timer), "Timer.bmp") imageButton.ImageScaling = ToolStripItemImageScaling.SizeToFit ' Set the background color of the image to be transparent. imageButton.ImageTransparentColor = Color.FromArgb(0, 255, 0) ' Show ToolTip text, set custom ToolTip text, and turn ' off the automatic ToolTips. toolStrip1.ShowItemToolTips = True imageButton.ToolTipText = "Click for the current time" imageButton.AutoToolTip = False ' Add the button to the ToolStrip. toolStrip1.Items.Add(imageButton) End Sub
internal ToolStripButton imageButton; private void InitializeImageButtonWithToolTip() { // Construct the button and set the image-related properties. imageButton = new ToolStripButton(); imageButton.Image = new Bitmap(typeof(Timer), "Timer.bmp"); imageButton.ImageScaling = ToolStripItemImageScaling.SizeToFit; // Set the background color of the image to be transparent. imageButton.ImageTransparentColor = Color.FromArgb(0, 255, 0); // Show ToolTip text, set custom ToolTip text, and turn // off the automatic ToolTips. toolStrip1.ShowItemToolTips = true; imageButton.ToolTipText = "Click for the current time"; imageButton.AutoToolTip = false; // Add the button to the ToolStrip. toolStrip1.Items.Add(imageButton); }
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
.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.