ToolStripItemImageScaling Enumeration

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Gibt an, ob die Größe des Bilds auf einem ToolStripItem automatisch angepasst wird, sodass es auf einen ToolStrip passt. Dabei bleiben die ursprünglichen Bildproportionen erhalten.

public enum class ToolStripItemImageScaling

public enum ToolStripItemImageScaling

type ToolStripItemImageScaling = 

Public Enum ToolStripItemImageScaling

Vererbung

Object

ValueType

Enum

ToolStripItemImageScaling

Felder

None	0	Gibt an, dass die Bildgröße auf einem ToolStripItem nicht automatisch so angepasst wird, dass es auf einen ToolStrip passt.
SizeToFit	1	Gibt an, dass die Bildgröße auf einem ToolStripItem automatisch so angepasst wird, dass es auf einen ToolStrip passt.

Beispiele

Im folgenden Beispiel wird die ToolStripItem.ImageScaling Eigenschaft auf 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

Hinweise

Die Image, ImageAlign, ImageIndex, ImageKeyund ImageScaling Eigenschaften beziehen sich auf verschiedene Aspekte der Bildbehandlung. Verwenden Sie Bilder in ToolStrip Steuerelementen, indem Sie diese Eigenschaften direkt festlegen oder die Nur-Laufzeit-Eigenschaft ImageList festlegen.

Die Bildskalierung wird durch die Interaktion von Eigenschaften in beiden ToolStrip und ToolStripItemwie folgt bestimmt:

• ImageScalingSize ist die Skalierung des endgültigen Bilds, wie durch die Kombination der Einstellung des Bilds ImageScaling und der Einstellung des AutoSize Containers bestimmt wird.

  • true Wenn AutoSize (standard) und ToolStripItemImageScaling ist SizeToFit, tritt keine Bildskalierung auf, und die ToolStrip Größe ist das des größten Elements oder eine vorgeschriebene Mindestgröße.

  • Ist AutoSize und ToolStripItemImageScaling ist None, tritt weder Bild noch ToolStrip Skalierung auf.false

Verwenden Sie die ImageScalingSize Eigenschaft, um die Bildgröße zu steuern.