ToolStripItemImageScaling ToolStripItemImageScaling ToolStripItemImageScaling ToolStripItemImageScaling Enum

定义

指定 ToolStripItem 上的图像的大小是否自动调整为适合 ToolStrip 的大小,并同时保持原始图像的比例。Specifies whether the size of the image on a ToolStripItem is automatically adjusted to fit on a ToolStrip while retaining the original image proportions.

public enum class ToolStripItemImageScaling
public enum ToolStripItemImageScaling
type ToolStripItemImageScaling = 
Public Enum ToolStripItemImageScaling
继承
ToolStripItemImageScalingToolStripItemImageScalingToolStripItemImageScalingToolStripItemImageScaling

字段

None None None None 0

指定 ToolStripItem 上的图像的大小不自动调整为适合 ToolStrip 的大小。Specifies that the size of the image on a ToolStripItem is not automatically adjusted to fit on a ToolStrip.

SizeToFit SizeToFit SizeToFit SizeToFit 1

指定 ToolStripItem 上的图像的大小自动调整为适合 ToolStrip 的大小。Specifies that the size of the image on a ToolStripItem is automatically adjusted to fit on a ToolStrip.

示例

下面的示例将ToolStripItem.ImageScaling属性设置为。 SizeToFitThe following example sets the ToolStripItem.ImageScaling property to 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

注解

Image、 、、ImageAlign和属性与图像处理的ImageScaling各个方面相关。 ImageIndex ImageKeyThe Image, ImageAlign, ImageIndex, ImageKey, and ImageScaling properties pertain to various aspects of image handling. 通过直接设置ToolStrip这些属性或通过设置运行时ImageList属性来使用控件中的图像。Use images in ToolStrip controls by setting these properties directly or by setting the run-time-only ImageList property.

图像缩放是通过ToolStripToolStripItem中的属性交互确定的, 如下所示:Image scaling is determined by the interaction of properties in both ToolStrip and ToolStripItem, as follows:

  • ImageScalingSize最终映像的小数位数, 由图像ImageScaling设置和AutoSize容器设置的组合确定。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.

    • 如果AutoSize ToolStripItemImageScalingtrue (默认值) 并且为SizeToFit, 则不会进行图像缩放, ToolStrip并且大小是最大项的大小, 或者是指定的最小大小。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.

    • 如果AutoSizefalseToolStrip为,则None不会发生图像和缩放。 ToolStripItemImageScalingIf AutoSize is false and ToolStripItemImageScaling is None, neither image nor ToolStrip scaling occurs.

若要控制图像大小, 请使用ImageScalingSize属性。To control the image size, use the ImageScalingSize property.

适用于