ToolStripItem.ImageScaling Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se uma imagem em um ToolStripItem é redimensionada automaticamente para se ajustar em um contêiner.

C#

public System.Windows.Forms.ToolStripItemImageScaling ImageScaling { get; set; }

Valor da propriedade

ToolStripItemImageScaling

Um dos valores de ToolStripItemImageScaling. O padrão é SizeToFit.

Exemplos

O exemplo de código a seguir demonstra como definir o Image, ImageScalinge ImageTransparentColor para um ToolStripItem. Além disso, ele demonstra como definir e mostrar uma Dica de Ferramenta personalizada para o item.

C#

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

Comentários

As Imagepropriedades , ImageAligne ImageKeyImageIndexImageScaling propriedades pertencem a vários aspectos do tratamento de imagem. Use imagens em ToolStrip controles definindo essas propriedades diretamente ou definindo a propriedade somente ImageList tempo de execução.

O dimensionamento de imagem é determinado pela interação das propriedades em ambos ToolStrip e ToolStripItem, da seguinte maneira:

• ImageScalingSize é a escala da imagem final, conforme determinado pela combinação da configuração da ImageScaling imagem e da configuração do AutoSize contêiner.

  • Se AutoSize for true (o padrão) e ToolStripItemImageScaling for SizeToFit, nenhum dimensionamento de imagem ocorrerá e o ToolStrip tamanho for o do maior item ou um tamanho mínimo prescrito.

  • Se AutoSize for false e ToolStripItemImageScaling for None, não ocorrerá imagem nem ToolStrip dimensionamento.

Aplica-se a