Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

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 codeDescription
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

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

Richedit.h

See also

EM_GETTABLEPARMS

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.