EM _ INSERTTABLE-Meldung
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 andernfalls einen Fehlercode.
Hinweise
Wenn das cpStartRow-Element von TABLEROWPARMS 1 ist, löscht diese Meldung den ausgewählten Text (falls vorhanden) und fügt dann leere Tabellenzeilen mit den Zeilen- und Zellenparametern ein, die von wParam und lParam angegeben werden. Die Auswahl bleibt so, dass sie auf den Anfang der ersten Zelle in der ersten Zeile verweist. Der Client kann dann die Tabellenzellen auffüllen, indem er die Auswahl (oder einen ITextRange)auf die verschiedenen Zellenendemarkierungen zeigt und den gewünschten Text einfügt und formatiert. Dieser Text kann geschachtelte Tabellenzeilen enthalten. Wenn der cpStartRow-Member von TABLEROWPARMS 0 oder höher ist, werden alternativ Tabellenzeilen an der von cpStartRow angegebenen Zeichenposition eingefügt. Dadurch wird die aktuelle Auswahl nur geändert, wenn die Tabelle in den ausgewählten 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 Absatz U+FFF9 U+000D mit zwei Zeichen und endet mit dem Absatz U+FFFB U+000D mit zwei Zeichen. Jede Zelle wird durch die Zellenmarkierung U+0007 beendet, die als harte Absatzendemarkierung behandelt wird, genauso wie U+000D (CR). Die Tabellenzeilen- und Zellenparameter werden als spezielle Absatzformatierung der Tabellenzeilentrennzeichen behandelt. Die Formatierung enthält die Informationen in der TABLEROWPARMS-Struktur. Die von der TABLECELLPARMS-Struktur angegebenen Zellenparameter werden in einer erweiterten Version des Tabstopparrays gespeichert. Mit diesem Format können Tabellen in anderen Tabellen geschachtelt werden, bis zu 15 Ebenen tief.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
[Windows 8 Nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
[Windows Server 2012 Nur Desktop-Apps] |
| Header |
|