Initial winforms content migrated (#18)

* Merge winforms framework content to working branch (#14) * Breadcrumb / TOC / Move net5 to net folder (#15) * change path from net5 to net * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Add .net 5 winforms placeholder article (#16) * added some metadata and adjusted net5 placeholder * corrections * corrections * corrections * Test1 * Swapping landing page vs concept * fix links * Fix links * Fix desc
2026-09-07 23:43:19 +02:00 · 2020-09-01 16:26:21 -07:00
parent 1a27c9b107
commit c0ba284473
1557 changed files with 129980 additions and 13 deletions
@@ -0,0 +1,55 @@
+---
+title: "Best Practices for the TableLayoutPanel Control"
+ms.date: "03/30/2017"
+helpviewer_keywords:
+  - "layout [Windows Forms]"
+  - "TableLayoutPanel control [Windows Forms], best practices"
+  - "forms [Windows Forms], best practices"
+  - "AutoSize property [Windows Forms], tableLayoutPanel control"
+  - "controls [Windows Forms], sizing"
+  - "TableLayoutPanel control [Windows Forms], AutoSize behavior"
+  - "layout [Windows Forms], AutoSize"
+  - "layout [Windows Forms], best practices"
+  - "best practices [Windows Forms], tableLayoutPanel control"
+  - "sizing [Windows Forms], automatic"
+  - "automatic sizing"
+ms.assetid: b6706efb-d7a4-45ec-8cf4-08fa993e3afb
+---
+# Best Practices for the TableLayoutPanel Control
+The <xref:System.Windows.Forms.TableLayoutPanel> control provides powerful layout features that you should consider carefully before using on your Windows Forms.
+
+## Recommendations
+ The following recommendations will help you use the <xref:System.Windows.Forms.TableLayoutPanel> control to its best advantage.
+
+### Targeted Use
+ Use the <xref:System.Windows.Forms.TableLayoutPanel> control sparingly. You should not use it in all situations that require a resizable layout. The following list describes layouts that benefit most from the use of the <xref:System.Windows.Forms.TableLayoutPanel> control:
+
+- Layouts in which there are multiple parts of the form that resize proportionally to each other.
+
+- Layouts that will be modified or generated dynamically at run time, such as data entry forms that have user-customizable fields added or subtracted based on preferences.
+
+- Layouts that should remain at an overall fixed size. For example, you may have a dialog box that should remain smaller than 800 x 600, but you need to support localized strings.
+
+ The following list describes layouts that do not benefit greatly from using the <xref:System.Windows.Forms.TableLayoutPanel> control:
+
+- Simple data entry forms with a single column of labels and a single column of text-entry areas.
+
+- Forms with a single large display area that should fill all the available space when a resize occurs. An example of this is a form that displays a single <xref:System.Windows.Forms.PropertyGrid> control. In this case, use anchoring, because nothing else should expand when the form is resized.
+
+ Choose carefully which controls need to be in a <xref:System.Windows.Forms.TableLayoutPanel> control. If you have room for your text to grow by 30% using anchoring, consider using the <xref:System.Windows.Forms.Control.Anchor%2A> property only. If you can estimate the space required by your layout, use of <xref:System.Windows.Forms.Control.Dock%2A> and <xref:System.Windows.Forms.Control.Anchor%2A> is easier than estimating the details of remaining space and <xref:System.Windows.Forms.Control.AutoSize%2A> behavior.
+
+ In general, when designing your layout with the <xref:System.Windows.Forms.TableLayoutPanel> control, keep the design as simple as possible.
+
+### Use the Document Outline Window
+ The Document Outline window gives you a tree view of your layout, which you can use to manipulate the z-order and parent-child relationships of your controls. From the **View menu**, select **Other Windows**, then select **Document Outline**.
+
+### Avoid Nesting
+ Avoid nesting other <xref:System.Windows.Forms.TableLayoutPanel> controls within a <xref:System.Windows.Forms.TableLayoutPanel> control. Debugging nested layouts can be difficult.
+
+### Avoid Visual Inheritance
+ The <xref:System.Windows.Forms.TableLayoutPanel> control does not support visual inheritance in the Windows Forms Designer in Visual Studio. A <xref:System.Windows.Forms.TableLayoutPanel> control in a derived class appears as "locked" at design time.
+
+## See also
+
+- <xref:System.Windows.Forms.TableLayoutPanel>
+- <xref:System.Windows.Forms.FlowLayoutPanel>