Mutually exclusive options<\/h2>\n
Nonzero values within the mask defined by tomConvertMask (0x00F00000) are mutually exclusive, that is, they cannot be combined (OR\u2019d) with one another. The options UnicodeMath, [La]TeX (tomConvertTeX), and Nemeth math braille (tomConvertNemeth) are also mutually exclusive. You can set only one at a time. But other options can be OR\u2019d in if desired.<\/p>\n
Nemeth math braille options<\/h2>\n
A string of Nemeth math braille codes in the Unicode range U+2800..U+283F can be inserted and built up by calling ITextRange2::SetText2(tomConvertNemeth, bstr). If the string is valid, you can get it back in any of the math formats including Nemeth math braille. For example, if you insert the string<\/p>\n
\u2839\u2802\u280c\u2806\u2828\u280f\u283c\u282e\u2830\u2834\u2818\u2806\u2828\u280f\u2810\u2839\u2828\u2808\u2808\u2819\u2828\u2839\u280c\u2801\u282c\u2803\u2800\u280e\u280a\u281d\u2800\u2828\u2839\u283c\u2800\u2828\u2805\u2800\u2839\u2802\u280c\u281c\u2801\u2818\u2806\u2810\u2824\u2803\u2818\u2806\u2810\u283b\u283c<\/p>\n
you see<\/p>\n
You can also input braille with a standard keyboard by typing a control word \\braille assigned to the Unicode character U+24B7 (\u24b7). (See LaTeX Math in Office<\/a> for how to add commands to math autocorrect). The \\braille command causes math input to accept braille input via a regular keyboard using the braille ASCII codes<\/a> sometimes referred to as North American Braille Computer Codes. The character ~ (U+007E) disables this input mode. These braille codes are described in the post Nemeth Braille\u2014the first math linear format<\/a> and can be input using refreshable braille displays<\/a>. Alternatively, such input can be automated by calling ITextSelection::TypeText<\/a>(bstr). Just as in entering UnicodeMath, the equations build up on screen as soon as the math braille input becomes unambiguous. The implementation includes the math braille UI<\/a> that cues the user where the insertion point is for unambiguous editing of math zones using braille. Note that as of this posting, the math braille facility isn\u2019t hooked up to Narrator or other screen readers.<\/p>\n The tomConvertMathSpeech currently only gets math speech in English. Microsoft Office apps like Word, PowerPoint and OneNote deliver math speech<\/a> in over 18 languages to the assistive technology (AT) program Narrator via the UIA ITextRangeProvider::GetText<\/a>() function. Other ATs could also get math speech this way, although they usually get MathML and generate speech from that. Dictating (setting) math speech would be nice for both blind and sighted folks. Imagine, you can say \ud835\udc4e\u00b2 + \ud835\udc4f\u00b2 = \ud835\udc50\u00b2 faster than you can type it or write it! The SetText2(tomConvertMathSpeech, bstr) is ready to handle such input, but the feature is not available yet.<\/p>\n In a nonmath context, the option, tomConvertRuby (0x00100000), can be used to convert strings like \u201c{\u2026|\u2026}\u201d to ruby inline objects<\/a>, where the first ellipsis represents the ruby text and the second ellipsis the base text. The ASCII curly braces and vertical bar are translated to the internal ruby-object structure characters U+FDD1, U+FDEF, and U+FDEE, respectively. Alternatively, the string can contain those structure characters directly. If a digit follows the start delimiter (\u2018{\u2018 or U+FDD1}, the digit defines the ruby options<\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/math-in-office\/wp-content\/uploads\/sites\/65\/2021\/02\/integral-300x69.jpg\")
<\/a><\/p>\nGetting (and Setting) Math Speech<\/h2>\n
Entering ruby text<\/h2>\n
![\"Image](\"https:\/\/devblogs.microsoft.com\/math-in-office\/wp-content\/uploads\/sites\/65\/2022\/09\/ruby.png\")
<\/a><\/p>\n![\"Image](\"https:\/\/devblogs.microsoft.com\/math-in-office\/wp-content\/uploads\/sites\/65\/2022\/09\/rubyc-e1664499589171.png\")
<\/a><\/p>\n