EM_INSERTTABLE Nachricht

Fügt eine oder mehrere identische Tabellenzeilen mit leeren Zellen ein.

#define EM_INSERTTABLE       (WM_USER + 232)

Parameter

wParam

Ein Zeiger auf eine TABLEROWPARMS-Struktur .

lParam

Ein Zeiger auf eine TABLECELLPARMS-Struktur .

Rückgabewert

Gibt S_OK zurück, wenn die Tabelle eingefügt wird, oder einen Fehlercode, falls nicht.

Hinweise

Wenn das cpStartRow-Element des TABLEROWPARMS -1 ist, löscht diese Meldung den markierten Text (falls vorhanden) und fügt dann leere Tabellenzeilen mit den zeilen- und zellparametern ein, die von wParam und lParam angegeben werden. Die Auswahl wird auf den Anfang der ersten Zelle in der ersten Zeile gezeigt. Der Client kann dann die Tabellenzellen auffüllen, indem er die Auswahl (oder eine ITextRange) auf die verschiedenen Zellendmarkierungen zeigt und den gewünschten Text einfügt und formatiert. Dieser Text kann geschachtelte Tabellenzeilen enthalten. Wenn das cpStartRow-Element des TABLEROWPARMS-Elements 0 oder höher ist, werden Tabellenzeilen an der von cpStartRow angegebenen Zeichenposition eingefügt. Dadurch wird die aktuelle Auswahl nur geändert, wenn die Tabelle in den markierten Text eingefügt wird.

Eine Microsoft Rich Edit-Tabelle besteht aus einer Sequenz von Tabellenzeilen, die wiederum aus Sequenzen von Absätzen bestehen. Eine Tabellenzeile beginnt mit dem speziellen zweistelligen Trennzeichenabsatz U+FFF9 U+000D und endet mit dem zweistelligen Trennzeichenabsatz U+FFFB U+000D. Jede Zelle wird durch die Zellmarkierung U+0007 beendet, die genauso wie U+000D (CR) als feste Absatzendemarke behandelt wird. Die Tabellenzeilen- und Zellparameter werden als spezielle Absatzformatierung der Tabellenzeilentrennzeichen behandelt. Die Formatierung enthält die Informationen in der TABLEROWPARMS-Struktur . Die von der TABLECELLPARMS-Struktur angegebenen Zellparameter werden in einer erweiterten Version des Registerkartenarrays gespeichert. Dieses Format ermöglicht das Verschachteln von Tabellen in anderen Tabellen mit einer Tiefe von bis zu fünfzehn Ebenen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Header	Richedit.h

Siehe auch

EM_INSERTIMAGE