Skip to content

Commit 5905bb6

Browse files
authored
Update TableLayoutPanel.xml (#4814)
1 parent df4d974 commit 5905bb6

File tree

1 file changed

+12
-4
lines changed

1 file changed

+12
-4
lines changed

xml/System.Windows.Forms/TableLayoutPanel.xml

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -319,12 +319,16 @@
319319
<ReturnType>System.Int32</ReturnType>
320320
</ReturnValue>
321321
<Docs>
322-
<summary>Gets or sets the number of columns in the table.</summary>
323-
<value>The number of columns in the <see cref="T:System.Windows.Forms.TableLayoutPanel" /> control. The default is 0.</value>
322+
<summary>Gets or sets the maximum number of columns allowed in the table.</summary>
323+
<value>The maximum number of columns in the <see cref="T:System.Windows.Forms.TableLayoutPanel" /> control. The default is 0.</value>
324324
<remarks>
325325
<format type="text/markdown"><![CDATA[
326326
327327
## Remarks
328+
Setting the <xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A> property does not create columns or allocate any backing memory. Memory allocation occurs when the columns are created, so you can set this property to <xref:System.Int32.MaxValue>.
329+
330+
Setting this property causes the table to undergo another layout operation.
331+
328332
You can specify both the <xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A> and the <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A> properties for layouts with a known and fixed number of cells. You can also specify one property or the other if you expect the number of cells in your layout to grow, assuming that the <xref:System.Windows.Forms.TableLayoutPanel.GrowStyle%2A> property allows for such growth. If the value of <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A> is 0, the panel will grow by adding rows, and if the value of <xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A> is 0, the panel will grow by adding columns. Specifying panel growth with the <xref:System.Windows.Forms.TableLayoutPanel.GrowStyle%2A> property is preferred to setting <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A> or <xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A> to 0, however.
329333
330334
Controls can be added or deleted from the table using the <xref:System.Windows.Forms.TableLayoutPanel.Controls%2A> property.
@@ -1182,12 +1186,16 @@
11821186
<ReturnType>System.Int32</ReturnType>
11831187
</ReturnValue>
11841188
<Docs>
1185-
<summary>Gets or sets the number of rows in the table.</summary>
1186-
<value>The number of rows in the <see cref="T:System.Windows.Forms.TableLayoutPanel" /> control. The default is 0.</value>
1189+
<summary>Gets or sets the maximum number of rows allowed in the table.</summary>
1190+
<value>The maximum number of rows in the <see cref="T:System.Windows.Forms.TableLayoutPanel" /> control. The default is 0.</value>
11871191
<remarks>
11881192
<format type="text/markdown"><![CDATA[
11891193
11901194
## Remarks
1195+
Setting the <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A> property does not create rows or allocate any backing memory. Memory allocation occurs when the rows are created, so you can set this property to <xref:System.Int32.MaxValue>.
1196+
1197+
Setting this property causes the table to undergo another layout operation.
1198+
11911199
You can specify both the <xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A> and the <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A> properties for layouts with a known and fixed number of cells. You can also specify one property or the other if you expect the number of cells in your layout to grow, assuming that the <xref:System.Windows.Forms.TableLayoutPanel.GrowStyle%2A> property allows for such growth. If the value of <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A> is 0, the panel will grow by adding rows, and if the value of <xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A> is 0, the panel will grow by adding columns. Specifying panel growth with the <xref:System.Windows.Forms.TableLayoutPanel.GrowStyle%2A> property is preferred to setting <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A> or <xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A> to 0, however.
11921200
11931201
Controls can be added or deleted from the table using the <xref:System.Windows.Forms.TableLayoutPanel.Controls%2A> property.

0 commit comments

Comments
 (0)