Edit

EM_GETTABLEPARMS message

  • Article

Retrieves the table parameters for a table row and the cell parameters for the specified number of cells.

#define EM_GETTABLEPARMS       (WM_USER + 265)

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 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 cbRow member of the TABLEROWPARMS structure 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 the TABLEROWPARMS structure must equal sizeof(TABLECELLPARMS). The query character position must be at a table row delimiter.
E_OUTOFMEMORY
Insufficient memory is available.

Remarks

This message gets the table parameters for the row at the character position specified by the cpStartRow member of the TABLEROWPARMS structure, and the number of cells specified by the cCells member of the TABLECELLPARMS structure.

The character position specified by the cpStartRow member of the TABLEROWPARMS structure should be at the start of the table row, or at the end delimiter of the table row. If cpStartRow is set to 1, the character position is given by the current selection. In this case, position the selection at the end of the row (between the cell mark and the end delimiter of the table row), or select the 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_SETTABLEPARMS