| Parameter | Description |
|---|---|
| capacity | The minimum buffer capacity, in UTF-16 code units. |
Pre-allocates the internal text buffer so that subsequent TextElement.SetText
(and related) calls of up to capacity UTF-16 code units do not allocate.
The buffer grows automatically on demand using a doubling strategy, so this method is never required for correctness. Use it only to pay the allocation cost up front.