ToolStripItem.ImageScaling Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Größe eines Bilds auf einem ToolStripItem automatisch geändert wird, damit es in einen Container passt, oder legt diesen Wert fest.Gets or sets a value indicating whether an image on a ToolStripItem is automatically resized to fit in a container.

public:
 property System::Windows::Forms::ToolStripItemImageScaling ImageScaling { System::Windows::Forms::ToolStripItemImageScaling get(); void set(System::Windows::Forms::ToolStripItemImageScaling value); };
public System.Windows.Forms.ToolStripItemImageScaling ImageScaling { get; set; }
member this.ImageScaling : System.Windows.Forms.ToolStripItemImageScaling with get, set
Public Property ImageScaling As ToolStripItemImageScaling

Eigenschaftswert

Einer der ToolStripItemImageScaling-Werte.One of the ToolStripItemImageScaling values. Die Standardeinstellung ist SizeToFit.The default is SizeToFit.

Beispiele

ImageIm folgenden Codebeispiel wird veranschaulicht, wie, und ImageScaling ImageTransparentColor für einen ToolStripItemfestgelegt werden.The following code example demonstrates how to set the Image, ImageScaling, and ImageTransparentColor for a ToolStripItem. Außerdem wird veranschaulicht, wie eine benutzerdefinierte QuickInfo für das Element festgelegt und angezeigt wird.In addition, it demonstrates how to set and show a custom ToolTip for the item.

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 ImageEigenschaften ImageAlign, ,ImageIndex ,ImageKeyund beziehenImageScaling sich auf verschiedene Aspekte der Bildverarbeitung.The Image, ImageAlign, ImageIndex, ImageKey, and ImageScaling properties pertain to various aspects of image handling. Verwenden Sie Bilder ToolStrip in Steuerelementen, indem Sie diese Eigenschaften direkt oder durch Festlegen der Lauf Zeit ImageList Eigenschaft festlegen.Use images in ToolStrip controls by setting these properties directly or by setting the run-time-only ImageList property.

Die Bildskalierung wird durch die Interaktion von Eigenschaften sowohl ToolStrip in ToolStripItemals auch in festgelegt, wie im folgenden dargestellt:Image scaling is determined by the interaction of properties in both ToolStrip and ToolStripItem, as follows:

Gilt für: