Difference between revisions of "Documentation/DevGuide/Text/Ruby"
OOoWikiBot (Talk | contribs) m (FINAL VERSION FOR L10N) |
|||
| Line 8: | Line 8: | ||
{{DISPLAYTITLE:Ruby}} | {{DISPLAYTITLE:Ruby}} | ||
<!--<idltopic>com.sun.star.style.CharacterProperties;com.sun.star.text.XRubySelection</idltopic>--> | <!--<idltopic>com.sun.star.style.CharacterProperties;com.sun.star.text.XRubySelection</idltopic>--> | ||
| − | Ruby text is a character layout attribute used in Asian languages. Ruby text appears above or below text in left to right writing, and left to right of text in top to bottom writing. For examples, cf. [ | + | Ruby text is a character layout attribute used in Asian languages. Ruby text appears above or below text in left to right writing, and left to right of text in top to bottom writing. For examples, cf. [https://www.w3.org/TR/1999/WD-ruby-19990322/ https://www.w3.org/TR/1999/WD-ruby-19990322/]. |
Ruby text is created using the appropriate character properties from the service <idl>com.sun.star.style.CharacterProperties</idl> wherever this service is supported. However, the Asian languages support must be switched on in '''Tools - Options - LanguageSettings - Languages'''. | Ruby text is created using the appropriate character properties from the service <idl>com.sun.star.style.CharacterProperties</idl> wherever this service is supported. However, the Asian languages support must be switched on in '''Tools - Options - LanguageSettings - Languages'''. | ||
| Line 21: | Line 21: | ||
!Description | !Description | ||
|- | |- | ||
| − | | | + | |<idlm> com.sun.star.style.CharacterProperties:RubyText</idlm> |
|Contains the text that is set as ruby. | |Contains the text that is set as ruby. | ||
|- | |- | ||
| − | | | + | |<idlm>com.sun.star.style.CharacterProperties:RubyAdjust</idlm> |
|Determines the adjustment of the ruby text as <code>RubyAdjust</code>. | |Determines the adjustment of the ruby text as <code>RubyAdjust</code>. | ||
|- | |- | ||
| − | | | + | |<idlm>com.sun.star.style.CharacterProperties:RubyCharStyleName</idlm> |
|Contains the name of the character style that is applied to <code>RubyText</code>. | |Contains the name of the character style that is applied to <code>RubyText</code>. | ||
|- | |- | ||
| − | | | + | |<idlm>com.sun.star.style.CharacterProperties:RubyIsAbove</idlm> |
|Determines if the ruby text is printed above/left or below/right of the text | |Determines if the ruby text is printed above/left or below/right of the text | ||
|} | |} | ||
Latest revision as of 14:39, 3 January 2021
Ruby text is a character layout attribute used in Asian languages. Ruby text appears above or below text in left to right writing, and left to right of text in top to bottom writing. For examples, cf. https://www.w3.org/TR/1999/WD-ruby-19990322/.
Ruby text is created using the appropriate character properties from the service com.sun.star.style.CharacterProperties wherever this service is supported. However, the Asian languages support must be switched on in Tools - Options - LanguageSettings - Languages.
There is no convenient supplier interface for ruby text at the model at this time. However, the controller has an interface com.sun.star.text.XRubySelection that provides access to rubies contained in the current selection.
To find ruby text in the model, enumerate all text portions in all paragraphs and check if the property TextPortionType contains the string "Ruby" to find ruby text. When there is ruby text, access the RubyText property of the text portion that contains ruby text as a string.
| CharacterProperties for Ruby Text | Description |
|---|---|
| RubyText | Contains the text that is set as ruby. |
| RubyAdjust | Determines the adjustment of the ruby text as RubyAdjust.
|
| RubyCharStyleName | Contains the name of the character style that is applied to RubyText.
|
| RubyIsAbove | Determines if the ruby text is printed above/left or below/right of the text |
| Content on this page is licensed under the Public Documentation License (PDL). |
