ToolStripItem.ImageScaling Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta un valore che indica se un'immagine su ToolStripItem viene automaticamente ridimensionata per adattarla a un contenitore.

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

Valore della proprietà

ToolStripItemImageScaling

Uno dei valori di ToolStripItemImageScaling. Il valore predefinito è SizeToFit.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare , ImageImageScalinge ImageTransparentColor per un ToolStripItemoggetto . Illustra inoltre come impostare e visualizzare una descrizione comando personalizzata per l'elemento.

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

Commenti

Le Imageproprietà , ImageAlign, ImageKeyImageIndex, e ImageScaling riguardano vari aspetti della gestione delle immagini. Usare le immagini nei ToolStrip controlli impostando queste proprietà direttamente o impostando la proprietà di sola esecuzione ImageList .

Il ridimensionamento delle immagini è determinato dall'interazione delle proprietà sia in ToolStrip e ToolStripItem, come indicato di seguito:

• ImageScalingSize è la scala dell'immagine finale, come determinato dalla combinazione dell'impostazione dell'immagine ImageScaling e dell'impostazione del AutoSize contenitore.

  • Se AutoSize è (impostazione predefinita) ed ToolStripItemImageScaling è trueSizeToFit, non si verifica il ridimensionamento delle immagini e la ToolStrip dimensione è quella dell'elemento più grande o di una dimensione minima prevista.

  • Se AutoSize è e ToolStripItemImageScaling è Nonefalse , né immagine né ToolStrip ridimensionamento si verifica.