ToolStripItem.ImageScaling ToolStripItem.ImageScaling ToolStripItem.ImageScaling ToolStripItem.ImageScaling Property

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é

Exemples

L’exemple de code suivant montre comment définir le Image, ImageScaling, et ImageTransparentColor pour un ToolStripItem.The following code example demonstrates how to set the Image, ImageScaling, and ImageTransparentColor for a ToolStripItem. En outre, il montre comment définir et afficher une info-bulle personnalisée pour l’élément.In addition, it demonstrates how to set and show a custom ToolTip for the item.

    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

Le Image, ImageAlign, ImageIndex, ImageKey, et ImageScaling propriétés relatives à divers aspects de la gestion des images.The Image, ImageAlign, ImageIndex, ImageKey, and ImageScaling properties pertain to various aspects of image handling. Utiliser des images dans ToolStrip contrôles en définissant ces propriétés directement ou en définissant l’exécution uniquement au moment du ImageList propriété.Use images in ToolStrip controls by setting these properties directly or by setting the run-time-only ImageList property.

Mise à l’échelle de l’image est déterminé par l’interaction des propriétés dans les deux ToolStrip et ToolStripItem, comme suit :Image scaling is determined by the interaction of properties in both ToolStrip and ToolStripItem, as follows:

• ImageScalingSize échelle de l’image finale, tel que déterminé par la combinaison de l’image ImageScaling paramètre et du conteneur AutoSize paramètre.ImageScalingSize is the scale of the final image as determined by the combination of the image's ImageScaling setting and the container's AutoSize setting.

  • Si AutoSize est true (la valeur par défaut) et ToolStripItemImageScaling est SizeToFit, aucune image mise à l’échelle se produit et le ToolStrip taille est celle de l’élément plus grand, ou une taille minimale recommandée.If AutoSize is true (the default) and ToolStripItemImageScaling is SizeToFit, no image scaling occurs, and the ToolStrip size is that of the largest item, or a prescribed minimum size.

  • Si AutoSize est false et ToolStripItemImageScaling est None, aucune image ni ToolStrip mise à l’échelle se produit.If AutoSize is false and ToolStripItemImageScaling is None, neither image nor ToolStrip scaling occurs.

S’applique à