ToolStripItemImageScaling Enumeración

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

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.

public enum class ToolStripItemImageScaling
public enum ToolStripItemImageScaling
type ToolStripItemImageScaling = 
Public Enum ToolStripItemImageScaling
Herencia
Object
ValueType
Enum
ToolStripItemImageScaling

Campos

None 0

Especifica que el tamaño de la imagen de un ToolStripItem no se ajusta automáticamente para caber en un ToolStrip.
SizeToFit 1

Especifica que el tamaño de la imagen de un ToolStripItem se ajusta automáticamente y cabe en un ToolStrip.

Ejemplos

En el ejemplo siguiente se establece la ToolStripItem.ImageScaling propiedad en SizeToFit.

ToolStripButton^ imageButton;

void InitializeImageButtonWithToolTip()
{

    // Construct the button and set the image-related properties.
    imageButton = gcnew ToolStripButton;
    imageButton->Image = 
        gcnew Bitmap(Timer::typeid,"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);
}


//   internal:

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

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

Comentarios

Las Imagepropiedades , ImageAlign, ImageIndex, ImageKeyy ImageScaling pertenecen a varios aspectos del control de imágenes. Use imágenes en ToolStrip controles estableciendo estas propiedades directamente o estableciendo la propiedad solo ImageList en tiempo de ejecución.

El escalado de imágenes viene determinado por la interacción de las propiedades en ToolStrip y ToolStripItem, como se indica a continuación:

  • ImageScalingSize es la escala de la imagen final determinada por la combinación de la configuración de la imagen ImageScaling y la configuración del AutoSize contenedor.

    • Si AutoSize es true (el valor predeterminado) y ToolStripItemImageScaling es SizeToFit, no se produce ningún escalado de imágenes y el ToolStrip tamaño es el del elemento más grande o un tamaño mínimo prescrito.

    • Si AutoSize es y ToolStripItemImageScaling es None``false , no se produce ninguna imagen ni ToolStrip escalado.

Para controlar el tamaño de la imagen, use la ImageScalingSize propiedad .

Se aplica a