ToolStripItem.ImageScaling

.NET Framework クラス ライブラリ リファレンス

ToolStripItem.ImageScaling プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ToolStripItem 上のイメージが、コンテナに合わせて自動的にサイズ変更されるかどうかを示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property ImageScaling As
 ToolStripItemImageScaling

Visual Basic (使用法)

Dim instance As ToolStripItem
Dim value As ToolStripItemImageScaling

value = instance.ImageScaling

instance.ImageScaling = value

C#

[LocalizableAttribute(true)] 
public ToolStripItemImageScaling ImageScaling { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
property ToolStripItemImageScaling ImageScaling {
    ToolStripItemImageScaling get ();
    void set (ToolStripItemImageScaling value);
}

J#

/** @property */
public ToolStripItemImageScaling get_ImageScaling ()

/** @property */
public void set_ImageScaling (ToolStripItemImageScaling
 value)

JScript

public function get ImageScaling
 () : ToolStripItemImageScaling

public function set ImageScaling
 (value : ToolStripItemImageScaling)

プロパティ値
ToolStripItemImageScaling 値の 1 つ。既定値は SizeToFit です。

使用例

ToolStripItem の Image、ImageScaling、および ImageTransparentColor を設定する方法を次のコード例に示します。また、項目にカスタム ツールヒントを設定および表示する方法を示します。

Visual Basic

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

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

}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ToolStripItem クラス
ToolStripItem メンバ
System.Windows.Forms 名前空間

ToolStripItemImageScaling 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Enumeration ToolStripItemImageScaling

Visual Basic (使用法)

Dim instance As ToolStripItemImageScaling

C#

public enum ToolStripItemImageScaling

C++

public enum class ToolStripItemImageScaling

J#

public enum ToolStripItemImageScaling

JScript

public enum ToolStripItemImageScaling

メンバ

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

解説

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

使用例

SizeToFit メンバを ToolStripButton に適用するコード例を次に示します。

Visual Basic

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

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

}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Windows.Forms 名前空間