Edit

EM_SETTABLEPARMS message

  • Article

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
E_FAIL
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.
E_INVALIDARG
 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.
E_OUTOFMEMORY
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
Richedit.h

See also

EM_GETTABLEPARMS