EM_SETTABLEPARMS message
Changes the parameters of rows in a table.
Parameters
-
wParam
-
A pointer to a TABLEROWPARMS structure.
-
lParam
-
A pointer to a TABLECELLPARMS structure.
Return value
Returns S_OK if successful, or one of the following error codes.
| Return code | Description |
|---|---|
|
Changes cannot be made. This can occur if the control is a plain-text or single-line control, or if the insertion point is inside a math object. It also occurs if tables are disabled, or if the EM_SETEDITSTYLEEX message sets the SES_EX_NOTABLE value. |
|
The wParam or lParam is NULL or points to an invalid structure. The cCell member of the TABLEROWPARMS structure must be at least 1 and not more than 63. The cbRow member must equal sizeof(TABLEROWPARMS) or sizeof(TABLEROWPARMS) 2*sizeof(long). The latter value is the size of the RichEdit 4.1 TABLEROWPARMS structure. The cbCell member of TABLEROWPARMS must equal sizeof(TABLECELLPARMS). The insertion point must be at the start of a table or inside a table row, and the number of cells can only change by one. |
|
Insufficient memory is available. |
Remarks
This message changes the parameters of the number of rows specified by the cRow member of the TABLEROWPARMS structure, if the table has that many consecutive rows. If cRow is less than 0, the message iterates until the end of the table. If the new cell count differs from the current cell count by +1 or 1, it inserts or deletes the cell at the index specified by the iCell member of TABLEROWPARMS. The starting table row is identified by a character position. This position is specified by cpStartRow members with values that are greater than or equal to zero. The position should be inside the table row, but not inside a nested table, unless you want to change that table s parameters. If the cpStartRow member is 1, the character position is given by the current selection. For this, position the selection anywhere inside the table row, or select the row with the active end of the selection at the end of the table row.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 8 [desktop apps only] |
| Minimum supported server |
Windows Server 2012 [desktop apps only] |
| Header |
|