(0) exportieren Drucken
Alle erweitern
Erweitern Minimieren

ToolStripItem.ImageScaling-Eigenschaft

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.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

[LocalizableAttribute(true)] 
public ToolStripItemImageScaling ImageScaling { get; set; }
/** @property */
public ToolStripItemImageScaling get_ImageScaling ()

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

public function get ImageScaling () : ToolStripItemImageScaling

public function set ImageScaling (value : ToolStripItemImageScaling)

Nicht zutreffend.

Eigenschaftenwert

Einer der ToolStripItemImageScaling-Werte. Der Standardwert ist SizeToFit.

Die Eigenschaften Image, ImageAlign, ImageIndex, ImageKey und ImageScaling betreffen verschiedene Aspekte der Bildbehandlung. Verwenden Sie Bilder in ToolStrip-Steuerelementen durch direktes Festlegen dieser Eigenschaften oder durch Festlegen ImageList-Eigenschaft nur zur Laufzeit.

Die Bildskalierung wird durch die Interaktion der Eigenschaften in ToolStrip und ToolStripItem folgendermaßen bestimmt:

  • ImageScalingSize ist die Skalierung des endgültigen Bilds entsprechend der Kombination aus der ImageScaling-Einstellung des Bilds und der AutoSize-Einstellung des Containers.

    • Wenn AutoSize auf true (Standardeinstellung) und ToolStripItemImageScaling auf SizeToFit festgelegt ist, erfolgt keine Bildskalierung, und die ToolStrip-Größe ist die des größten Elements oder die vorgegebene Mindestgröße.

    • Wenn AutoSize auf false und ToolStripItemImageScaling auf None festgelegt ist, werden weder das Bild noch der ToolStrip skaliert.

Im folgenden Codebeispiel wird veranschaulicht, wie Image, ImageScaling und ImageTransparentColor für ein ToolStripItem festgelegt werden. Darüber hinaus wird veranschaulicht, wie eine benutzerdefinierte QuickInfo für das Element festgelegt und angezeigt wird.

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 Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

.NET Framework

Unterstützt in: 3.0, 2.0
Anzeigen:
© 2014 Microsoft