ToolStripItemImageScaling 列挙型

定義

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
継承
ToolStripItemImageScaling

フィールド

None 0

ToolStripItem 上のイメージのサイズを、ToolStrip に合わせて自動的に調節しないよう指定します。Specifies that the size of the image on a ToolStripItem is not automatically adjusted to fit on a ToolStrip.

SizeToFit 1

ToolStripItem 上のイメージのサイズを、ToolStrip に合わせて自動的に調節するよう指定します。Specifies that the size of the image on a ToolStripItem is automatically adjusted to fit on a ToolStrip.

次の例ではToolStripItem.ImageScaling 、プロパティSizeToFitをに設定します。The 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

注釈

ImageImageAlign、 、ImageKey、およびの各プロパティは、イメージ処理のさまざまな側面に関連します。ImageScaling ImageIndexThe 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.

イメージのスケーリングは、次のように、とToolStrip ToolStripItemの両方のプロパティの相互作用によって決定されます。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 SizeToFit (既定値ToolStrip ) であり、がである場合、イメージのスケーリングは行われず、サイズは最大の項目のサイズまたは指定された最小サイズになります。ToolStripItemImageScaling trueIf 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.

    • AutoSizefalse None ToolStrip 、がの場合、イメージもスケーリングも実行されません。 ToolStripItemImageScalingIf AutoSize is false and ToolStripItemImageScaling is None, neither image nor ToolStrip scaling occurs.

イメージのサイズを制御するにはImageScalingSize 、プロパティを使用します。To control the image size, use the ImageScalingSize property.

適用対象