Gets or sets the supplemental character rotation about the current text position.
HRESULT ISVGTextPositioningElement::get_rotate(ISVGAnimatedNumberList **p);HRESULT ISVGTextPositioningElement::put_rotate(ISVGAnimatedNumberList *v);
Returns S_OK if successful, or an error value otherwise.
The ISVGTextPositioningElement::rotate property gets or sets the supplemental rotation about the current text position that is applied to all of the glyphs that correspond to each character within this element.
If you provide a comma-separated or space-separated list of numbers, the first number represents the supplemental rotation for the glyphs that correspond to the first character within this element or any of its descendants, the second number represents the supplemental rotation for the glyphs that correspond to the second character, and so on.
If you provide more numbers than there are characters, the extra numbers are ignored. If more characters are provided than numbers, for each of these extra characters, the rotation value that is specified by the last number is used for these remaining characters.
If you do not specify the ISVGTextPositioningElement::rotate attribute and if an ancestor text or tSpan element specifies a supplemental rotation for a given character through a ISVGTextPositioningElement::rotate attribute, the specified supplemental rotation is applied to the given character (the nearest ancestor has precedence). If there are more characters than numbers that are specified in the ancestor's ISVGTextPositioningElement::rotate attribute, for each of these extra characters, the rotation value that is specified by the last number is used.
This supplemental rotation does not impact how the current text position is modified as glyphs get rendered and is supplemental to any rotation because of text on a path and to
glyph-orientation-vertical.Note If you do not specify the ISVGTextPositioningElement::rotate attribute on an element or any of its descendants, no supplemental rotations occur.
The following code example shows how to rotate individual characters. Because the number of rotate values is less than the number of characters in the string, all characters after the fourth character are rendered at 30°.<?xml version="1.0" standalone="no"?> <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"> <svg width="100%" height="100%" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"> <text font-family="Verdana" font-size="55" fill="blue" > <!-- --> <tspan x="250" y="150" rotate="-30, -15, 0, 15, 30"> Hello World! </tspan> </text> </svg>