ToolStrip.AutoSize Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

ToolStrip.cs

Obtém ou define um valor que indica se o controle é redimensionado automaticamente para exibir todo o seu conteúdo.

public:
 virtual property bool AutoSize { bool get(); void set(bool value); };

[System.ComponentModel.Browsable(true)]
public override bool AutoSize { get; set; }

[<System.ComponentModel.Browsable(true)>]
member this.AutoSize : bool with get, set

Public Overrides Property AutoSize As Boolean

Valor da propriedade

Boolean

true se o controle se ajusta à sua largura para que o conteúdo caiba; caso contrário, false. O padrão é true.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a seguir demonstra a sintaxe para definir propriedades comuns ToolStrip , incluindo a AutoSize propriedade .

// 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

Comentários

Se você definir AutoSize como false e o ToolStrip estiver inserido em um ToolStripContainer painel, os limites do ToolStrip não serão convertidos quando você mover o ToolStrip para um painel diferente do ToolStripContainer. Para traduzir os limites corretamente, sincronize o LayoutStyleChanged evento, marcar o valor da Orientation propriedade e redimensione o ToolStrip.

As Imagepropriedades , ImageAlign, ImageIndex, ImageKeye ImageScaling pertencem a vários aspectos do tratamento de imagem. Use imagens em ToolStrip controles definindo essas propriedades diretamente ou definindo a propriedade somente ImageList em tempo de execução.

O dimensionamento de imagens é determinado pela interação das propriedades em ToolStrip e ToolStripItem, da seguinte maneira:

• ImageScalingSize é a escala da imagem final, conforme determinado pela combinação da configuração da ImageScaling imagem e da configuração do AutoSize contêiner.

  • Se AutoSize for true (o padrão) e ToolStripItemImageScaling for SizeToFit, nenhum dimensionamento de imagem ocorrerá e o ToolStrip tamanho for o do maior item ou um tamanho mínimo prescrito.

  • Se AutoSize for false e ToolStripItemImageScaling for None, nem a imagem nem ToolStrip o dimensionamento ocorrerão.