Compartilhar via


EM_INSERTTABLE mensagem

Insere uma ou mais linhas de tabela idênticas com células vazias.

#define EM_INSERTTABLE       (WM_USER + 232)

Parâmetros

wParam

Um ponteiro para uma estrutura TABLEROWPARMS .

lParam

Um ponteiro para uma estrutura TABLECELLPARMS .

Retornar valor

Retornará S_OK se a tabela for inserida ou um código de erro, caso contrário.

Comentários

Se o membro cpStartRow do TABLEROWPARMS for –1, essa mensagem excluirá o texto selecionado (se houver) e inserirá linhas de tabela vazias com os parâmetros de linha e célula fornecidos por wParam e lParam. Ele deixa a seleção apontando para o início da primeira célula na primeira linha. Em seguida, o cliente pode preencher as células da tabela apontando a seleção (ou um ITextRange) para as várias marcas de extremidade da célula e inserindo e formatando o texto desejado. Esse texto pode incluir linhas de tabela aninhadas. Como alternativa, se o membro cpStartRow do TABLEROWPARMS for 0 ou maior, as linhas de tabela serão inseridas na posição do caractere fornecida por cpStartRow. Isso só alterará a seleção atual se a tabela for inserida dentro do texto selecionado.

Uma tabela do Microsoft Rich Edit consiste em uma sequência de linhas de tabela que, por sua vez, consistem em sequências de parágrafos. Uma linha de tabela começa com o parágrafo delimitador especial de dois caracteres U+FFF9 U+000D e termina com o parágrafo delimitador de dois caracteres U+FFFB U+000D. Cada célula é encerrada pela marca de célula U+0007, que é tratada como uma marca de fim de parágrafo rígido, assim como U+000D (CR) é. Os parâmetros de linha e célula da tabela são tratados como formatação de parágrafo especial dos delimitadores de linha de tabela. A formatação contém as informações na estrutura TABLEROWPARMS . Os parâmetros de célula dados pela estrutura TABLECELLPARMS são armazenados em uma versão expandida da matriz de guias. Esse formato permite que as tabelas sejam aninhadas em outras tabelas, com até quinze níveis de profundidade.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho
Richedit.h

Confira também

EM_INSERTIMAGE