ToolStripItemImageScaling 列挙型

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ToolStripItem 上のイメージのサイズを、元のイメージの比率を維持しながら、ToolStrip に合わせて自動的に調節するかどうかを指定します。

public enum class ToolStripItemImageScaling

public enum ToolStripItemImageScaling

type ToolStripItemImageScaling = 

Public Enum ToolStripItemImageScaling

継承

Object

ValueType

Enum

ToolStripItemImageScaling

フィールド

None	0	ToolStripItem 上のイメージのサイズを、ToolStrip に合わせて自動的に調節しないよう指定します。
SizeToFit	1	ToolStripItem 上のイメージのサイズを、ToolStrip に合わせて自動的に調節するよう指定します。

例

次の例では、 プロパティを ToolStripItem.ImageScaling に 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、ImageIndex、ImageKey、ImageScaling の各プロパティは、画像処理のさまざまな側面に関連します。 コントロールで ToolStrip イメージを使用するには、これらのプロパティを直接設定するか、実行時専用 ImageList プロパティを設定します。

画像の拡大縮小は、次のように、ToolStrip と ToolStripItem 両方のプロパティの相互作用によって決定されます。

• ImageScalingSize は、画像の ImageScaling の設定とコンテナーの AutoSize の設定の組み合わせによって決定される最終的な画像のスケールです。

  • AutoSize が true (既定値) であり ToolStripItemImageScaling が SizeToFit の場合は、画像の拡大縮小は行われず、ToolStrip のサイズは最大の項目のサイズまたは指定された最小サイズになります。

  • AutoSize が false で、ToolStripItemImageScaling が None の場合は、画像と ToolStrip のどちらの拡大縮小も行われません。

イメージのサイズを制御するには、 プロパティを ImageScalingSize 使用します。