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

Комментарии

ImageСвойства,,, ImageAlign ImageIndex ImageKey и ImageScaling относятся к различным аспектам обработки изображений.The 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 параметр имеет значение true (по умолчанию) и ToolStripItemImageScaling имеет значение 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.

    • Если AutoSize имеет значение false и ToolStripItemImageScaling имеет значение, то не None происходит ни изображение, ни ToolStrip масштабирование.If AutoSize is false and ToolStripItemImageScaling is None, neither image nor ToolStrip scaling occurs.

Для управления размером изображения используйте ImageScalingSize свойство.To control the image size, use the ImageScalingSize property.

Применяется к