Méthode ITextRange2::BuildUpMath (tom.h)
Convertit le format mathématique au format linéaire d’une plage en un formulaire généré, ou modifie le formulaire généré actuel.
Syntaxe
HRESULT BuildUpMath(
[in] long Flags
);
Paramètres
[in] Flags
Type : long
Combinaison des indicateurs suivants.
tomChimiqueFormula
tomHaveDelimiter
tomMathAlphabetics
tomMathApplyTemplate
tomMathArabicAlphabetics
tomMathAutoCorrect
tomMathAutoCorrectExt
tomMathAutoCorrectOpPairs
tomMathBackspace
tomMathBuildDown
tomMathBuildDownOutermost
tomMathBuildUpArgOrZone
tomMathBuildUpRecurse
tomMathChangeMask
tomMathCollapseSel
tomMathDeleteArg
tomMathDeleteArg1
tomMathDeleteArg2
tomMathDeleteCol
tomMathDeleteRow
tomMathEnter
tomMathInsColAfter
tomMathInsColBefore
tomMathInsRowAfter
tomMathInsRowBefore
tomMathMakeFracLinear
tomMathMakeFracSlashed
tomMathMakeFracStacked
tomMathMakeLeftSubSup
tomMathMakeSubSup
tomMathRemoveOutermost
tomMathRichEdit
tomMathShiftTab
tomMathSingleChar
tomMathSubscript
tomMathSuperscript
tomMathTab
tomNeedTermOp
tomPlain
tomShowEmptyArgPlaceholders
tomTeX
Valeur retournée
Type : HRESULT
Si la méthode réussit, elle retourne NOERROR. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Si la méthode ITextRange2::BuildUpMath est appelée sur une plage non dégénérée, la méthode recherche dans le texte les conversions mathématiques italiques (si tomMathAlphabetics est spécifié) et les conversions de correction automatique mathématique (si tomMathAutoCorrect ou tomMathAutoCorrectExt est spécifié). Ensuite, la méthode tente de générer le texte sélectionné. Si elle réussit, la méthode remplace le texte précédent de la plage par le texte généré. Si la méthode apporte des modifications à la plage, la fonction retourne NOERROR et la plage sélectionne le résultat. Si la méthode modifie la plage, elle retourne S_FALSE ou un code d’erreur COM (Component Object Model).
Si la méthode ITextRange2::BuildUpMath est appelée sur une plage dégénérée, la méthode BuildUpMath traite la plage comme un point d’insertion (IP) immédiatement après la dernière entrée de caractère. La méthode convertit ce caractère, éventuellement avec certains caractères précédents, en italique mathématique (si tomMathAlphabetics est spécifié), en correction automatique mathématique interne (si tomMathAutoCorrect est spécifié), en opérateurs négation et certaines paires d’opérateurs (si tomMathAutoCorrectOpPairs est spécifié). Si l’adresse IP se trouve à l’intérieur d’un argument, la méthode analyse une plage de texte de l’adresse IP jusqu’au début d’un argument d’objet mathématique ; sinon, la méthode analyse jusqu’au début de la zone mathématique actuelle. L’analyse est terminée par un retour chariot dur ou une marque de fin de paragraphe souple, car les zones mathématiques sont terminées par ces marques. Une analyse à partir du début de l’argument d’objet mathématique ou de la zone mathématique contourne le texte qui n’a aucune chance d’être généré. Si l’analyse atteint l’adresse IP d’entrée d’origine, l’un des résultats suivants peut se produire :
- Si la méthode a apporté des modifications, la fonction retourne NOERROR et la plage mise à jour avec le texte modifié.
- Si la méthode n’a apporté aucune modification, la fonction retourne S_FALSE et laisse la plage inchangée.
Si cette tentative de build-up complète échoue, la méthode BuildUpMath effectue une build-up partielle case activée pour l’expression qui précède immédiatement l’adresse IP. Si cela réussit, la méthode retourne NOERROR et la plage contient le texte linéaire à remplacer par le texte généré.
Si les tentatives de build-up complète et partielle échouent, la fonction retourne comme décrit précédemment pour les cas où aucun texte de build-up n’a été trouvé. D’autres valeurs de retour possibles incluent E_INVALIDARG (si l’un des pointeurs d’interface a la valeur NULL) et E_OUTOFMEMORY.
Vous devez définir l’indicateur tomNeedTermOp pour la génération automatique de formule, sauf si une correction automatique s’est produite qui supprime le vide de fin. La correction automatique peut se produire lors de la correction de texte comme \alpha lorsque l’utilisateur tape un vide pour forcer la correction automatique.
Configuration requise
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | tom.h |
| DLL | Msftedit.dll |