ToolStripItem.ImageScaling Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit une valeur indiquant si une image sur un ToolStripItem est automatiquement redimensionnée pour contenir dans un conteneur.

public:
 property System::Windows::Forms::ToolStripItemImageScaling ImageScaling { System::Windows::Forms::ToolStripItemImageScaling get(); void set(System::Windows::Forms::ToolStripItemImageScaling value); };

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

member this.ImageScaling : System.Windows.Forms.ToolStripItemImageScaling with get, set

Public Property ImageScaling As ToolStripItemImageScaling

Valeur de propriété

ToolStripItemImageScaling

Une des valeurs de l'objet ToolStripItemImageScaling. La valeur par défaut est SizeToFit.

Exemples

L’exemple de code suivant montre comment définir le Image, ImageScalinget ImageTransparentColor pour un ToolStripItem. En outre, il montre comment définir et afficher une info-bulle personnalisée pour l’élément.

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

Remarques

Les Imagepropriétés , , et ImageKeyImageAlignImageIndexImageScaling les propriétés se rapportent à différents aspects de la gestion des images. Utilisez des images dans des contrôles en ToolStrip définissant ces propriétés directement ou en définissant la propriété run-time uniquement ImageList .

La mise à l’échelle de l’image est déterminée par l’interaction des propriétés dans les deux ToolStrip et ToolStripItem, comme suit :

• ImageScalingSize est l’échelle de l’image finale, déterminée par la combinaison du paramètre de ImageScaling l’image et du paramètre du AutoSize conteneur.

  • Si AutoSize elle est true (valeur par défaut) et ToolStripItemImageScaling SizeToFitqu’aucune mise à l’échelle d’image ne se produit, et la ToolStrip taille est celle du plus grand élément ou d’une taille minimale prescrite.

  • Si AutoSize c’est et ToolStripItemImageScaling est false None, ni l’image ni ToolStrip la mise à l’échelle ne se produisent.