Form.AutoSize 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

根据 AutoSizeMode 的设置调整窗体的大小。

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

属性值

Boolean

如果窗体将自动调整大小，则为 true；如果必须手动调整大小，则为 false。

属性

BrowsableAttribute

示例

以下示例显示了使用代码创建的窗体，该表单会自动调整大小以适应其内容。 运行时，窗体将显示一个 Label、一个 TextBox 用于输入 URL，以及一个 Button 用于在用户的默认 Web 浏览器内显示该 URL。 该示例使用一个 FlowLayoutPanel 来布局包含的控件。 它还设置 AutoSize 并 AutoSizeMode 增长和缩小以适应其形式的内容。

private void Form1_Load(object sender, EventArgs e)
{
    this.AutoSize = true;
    this.AutoSizeMode = AutoSizeMode.GrowAndShrink;
    this.Text = "URL Opener";

    flowPanel = new FlowLayoutPanel();
    flowPanel.AutoSize = true;
    flowPanel.AutoSizeMode = AutoSizeMode.GrowAndShrink;
    this.Controls.Add(flowPanel);

    urlLabel = new Label();
    urlLabel.Name = "urlLabel";
    urlLabel.Text = "URL:";
    urlLabel.Width = 50;
    urlLabel.TextAlign = ContentAlignment.MiddleCenter;
    flowPanel.Controls.Add(urlLabel);

    urlTextBox = new TextBox();
    urlTextBox.Name = "urlTextBox";
    urlTextBox.Width = 250;
    flowPanel.Controls.Add(urlTextBox);

    urlButton = new Button();
    urlButton.Name = "urlButton";
    urlButton.Text = "Open URL in Browser";
    urlButton.Click += new EventHandler(urlButton_Click);
    flowPanel.Controls.Add(urlButton);
}

void urlButton_Click(object sender, EventArgs e)
{
    try
    {
        Uri newUri = new Uri(urlTextBox.Text);
    }
    catch (UriFormatException uriEx)
    {
        MessageBox.Show("Sorry, your URL is malformed. Try again. Error: " + uriEx.Message);
        urlTextBox.ForeColor = Color.Red;
        return;
    }
    
    // Valid URI. Reset any previous error color, and launch the URL in the 
    // default browser.
    // NOTE: Depending on the user's settings, this method of starting the
    // browser may use an existing window in an existing Web browser process.
    // To get around this, start up a specific browser instance instead using one of
    // the overloads for Process.Start. You can examine the registry to find the
    // current default browser and launch that, or hard-code a specific browser.
    urlTextBox.ForeColor = Color.Black;
    Process.Start(urlTextBox.Text);
}

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    Me.AutoSize = True
    Me.AutoSizeMode = System.Windows.Forms.AutoSizeMode.GrowAndShrink
    Me.Text = "URL Opener"

    flowPanel = New FlowLayoutPanel()
    flowPanel.AutoSize = True
    flowPanel.AutoSizeMode = System.Windows.Forms.AutoSizeMode.GrowAndShrink
    Me.Controls.Add(flowPanel)

    urlLabel = New Label()
    urlLabel.Name = "urlLabel"
    urlLabel.Text = "URL:"
    urlLabel.Width = 50
    urlLabel.TextAlign = ContentAlignment.MiddleCenter
    flowPanel.Controls.Add(urlLabel)

    urlTextBox = New TextBox()
    urlTextBox.Name = "urlTextBox"
    urlTextBox.Width = 250
    flowPanel.Controls.Add(urlTextBox)

    urlButton = New Button()
    urlButton.Name = "urlButton"
    urlButton.Text = "Open URL in Browser"
    flowPanel.Controls.Add(urlButton)
End Sub


Private Sub urlButton_Click(ByVal sender As Object, ByVal e As EventArgs) Handles urlButton.Click
    Try
        Dim newUri As New Uri(urlTextBox.Text)
    Catch uriEx As UriFormatException
        MessageBox.Show(("Sorry, your URL is malformed. Try again. Error: " + uriEx.Message))
        urlTextBox.ForeColor = Color.Red
        Return
    End Try

    ' Valid URI. Reset any previous error color, and launch the URL in the 
    ' default browser.
    ' NOTE: Depending on the user's settings, this method of starting the
    ' browser may use an existing window in an existing Web browser process.
    ' To get around this, start up a specific browser instance instead using one of
    ' the overloads for Process.Start. You can examine the registry to find the
    ' current default browser and launch that, or hard-code a specific browser.
    urlTextBox.ForeColor = Color.Black
    Process.Start(urlTextBox.Text)
End Sub

注解

用于 AutoSize 强制窗体调整大小以适应其内容。

无论属性值和AutoSizeMode属性如何，AutoSize窗体都不会在 Visual Studio 窗体设计器中自动调整大小。 根据这两个属性的值，窗体在运行时正确调整自身大小。 相比之下，自定义 UserControl 会在设计时和运行时自动调整自身大小。

使用 AutoSize时， MinimumSize 将遵循属性和 MaximumSize 属性，但忽略该属性的 Size 当前值。 使用 AutoSize 和 AutoSizeMode 呈现 AutoScroll 属性多余的，因为无法收缩窗体以隐藏其包含的控件从视图中。

AutoSizeMode有关窗体在何时AutoSizetrue行为的信息，请参阅枚举。