ToolStrip.ImageScalingSize Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el tamaño, en píxeles, de una imagen usada en un elemento ToolStrip.
public:
property System::Drawing::Size ImageScalingSize { System::Drawing::Size get(); void set(System::Drawing::Size value); };public System.Drawing.Size ImageScalingSize { get; set; }member this.ImageScalingSize : System.Drawing.Size with get, setPublic Property ImageScalingSize As SizeValor de propiedad
Valor Size que representa el tamaño de la imagen, en píxeles. El valor predeterminado es 16 x 16 píxeles.
Ejemplos
En el ejemplo de código siguiente se muestra la sintaxis para establecer propiedades comunes ToolStrip , incluida la ImageScalingSize propiedad .
// This is an example of some common ToolStrip property settings.
//
toolStrip1.AllowDrop = false;
toolStrip1.AllowItemReorder = true;
toolStrip1.AllowMerge = false;
toolStrip1.Anchor = ((System.Windows.Forms.AnchorStyles)(((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Left)
| System.Windows.Forms.AnchorStyles.Right)));
toolStrip1.AutoSize = false;
toolStrip1.CanOverflow = false;
toolStrip1.Cursor = System.Windows.Forms.Cursors.Cross;
toolStrip1.DefaultDropDownDirection = System.Windows.Forms.ToolStripDropDownDirection.BelowRight;
toolStrip1.Dock = System.Windows.Forms.DockStyle.None;
toolStrip1.GripMargin = new System.Windows.Forms.Padding(3);
toolStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
toolStripButton1});
toolStrip1.ImageScalingSize = new System.Drawing.Size(20, 20);
toolStrip1.LayoutStyle = System.Windows.Forms.ToolStripLayoutStyle.HorizontalStackWithOverflow;
toolStrip1.Location = new System.Drawing.Point(0, 0);
toolStrip1.Margin = new System.Windows.Forms.Padding(1);
toolStrip1.Name = "toolStrip1";
toolStrip1.Padding = new System.Windows.Forms.Padding(0, 0, 2, 0);
toolStrip1.RenderMode = System.Windows.Forms.ToolStripRenderMode.System;
toolStrip1.ShowItemToolTips = false;
toolStrip1.Size = new System.Drawing.Size(109, 273);
toolStrip1.Stretch = true;
toolStrip1.TabIndex = 0;
toolStrip1.TabStop = true;
toolStrip1.Text = "toolStrip1";
toolStrip1.TextDirection = System.Windows.Forms.ToolStripTextDirection.Vertical90;
' This is an example of some common ToolStrip property settings.
'
toolStrip1.AllowDrop = False
toolStrip1.AllowItemReorder = True
toolStrip1.AllowMerge = False
toolStrip1.Anchor = CType(System.Windows.Forms.AnchorStyles.Top Or System.Windows.Forms.AnchorStyles.Left Or System.Windows.Forms.AnchorStyles.Right, System.Windows.Forms.AnchorStyles)
toolStrip1.AutoSize = False
toolStrip1.CanOverflow = False
toolStrip1.Cursor = Cursors.Cross
toolStrip1.Dock = System.Windows.Forms.DockStyle.None
toolStrip1.DefaultDropDownDirection = ToolStripDropDownDirection.BelowRight
toolStrip1.GripMargin = New System.Windows.Forms.Padding(3)
toolStrip1.ImageScalingSize = New System.Drawing.Size(20, 20)
toolStrip1.Items.AddRange(New System.Windows.Forms.ToolStripItem() {toolStripButton1})
toolStrip1.LayoutStyle = System.Windows.Forms.ToolStripLayoutStyle.HorizontalStackWithOverflow
toolStrip1.Location = New System.Drawing.Point(0, 0)
toolStrip1.Margin = New System.Windows.Forms.Padding(1)
toolStrip1.Name = "toolStrip1"
toolStrip1.Padding = New System.Windows.Forms.Padding(0, 0, 2, 0)
toolStrip1.RenderMode = System.Windows.Forms.ToolStripRenderMode.System
toolStrip1.ShowItemToolTips = False
toolStrip1.Size = New System.Drawing.Size(109, 273)
toolStrip1.Stretch = True
toolStrip1.TabIndex = 0
toolStrip1.TabStop = True
toolStrip1.Text = "toolStrip1"
toolStrip1.TextDirection = System.Windows.Forms.ToolStripTextDirection.Vertical90
Comentarios
Utilice la ToolStripItemImageScaling propiedad para controlar el tamaño predeterminado de una imagen. Use SizeToFit para hacer que el tamaño de la imagen se ToolStripItem ajuste automáticamente para ajustarse a un ToolStrip mientras conserva las proporciones de la imagen original.
Las propiedades Image, ImageAlign, ImageIndex, ImageKey y ImageScaling tienen que ver con diversos aspectos del control de imágenes. Use imágenes en ToolStrip controles estableciendo estas propiedades directamente o estableciendo la propiedad solo ImageList en tiempo de ejecución.
El escalado de imágenes viene determinado por la interacción de las propiedades tanto en ToolStrip como en ToolStripItem, como se indica a continuación:
ImageScalingSize es la escala de la imagen final según viene determinada por la combinación de la configuración de ImageScaling la imagen y la configuración de AutoSize del contenedor.
Si AutoSize es
true(valor predeterminado) y ToolStripItemImageScaling es SizeToFit, no se produce ningún escalado de imagen y el tamaño de ToolStrip es el del elemento más grande, o bien un tamaño mínimo prescrito.Si AutoSize es
falsey ToolStripItemImageScaling son None, no se produce ningún escalado de imagen ni de ToolStrip.
