Shape.GetFormulasU, méthode (Visio)

Renvoie les formules de nombreuses cellules.

Syntaxe

expression. GetFormulasU( _SRCStream()_ , _formulaArray()_ )

Expression Variable qui représente un objet Shape .

Parameters

Nom	Requis/Facultatif	Type de données	Description
SRCStream()	Requis	Integer	Flux qui identifie les cellules à interroger.
formulaArray()	Requis	Variant	Paramètre sortant. Tableau qui reçoit les formules des cellules interrogées.

Valeur renvoyée

Aucune

Remarques

La méthode GetFormulasU est comparable à la propriété FormulaU d'un objet Cell, à la différence que vous pouvez l'utiliser pour récupérer simultanément les formules de plusieurs cellules, au lieu de traiter les cellules une par une. La méthode GetFormulasU est une dérivation de la méthode GetResults permettant d'obtenir les formules ou résultats de cellule. La préparation d'un appel de méthode GetFormulasU est légèrement plus simple qu'avec la méthode GetResults.

Utilisez la méthode GetFormulasU pour obtenir les formules d’un ensemble de cellules.

FluxSRC() est un tableau d'entiers de 2 octets. Pour les objets Shape , SRCStream() doit être un tableau unidimensionnel de 3 n entiers de 2 octets pour certains n>= 1. GetFormulasU interprète le flux comme suit :

{sectionIdx, rowIdx, cellIdx}n

où IdxSection est l'index de section de la cellule souhaitée, IdxLigne est son index de ligne et IdxCellule son index de cellule.

Si la méthode GetFormulasU réussit, l'argument TableauFormules() renvoie un tableau à une dimension de n variants indexés de 0 à n - 1. Chaque variant renvoie une formule sous forme de chaîne. TableauFormules() est un paramètre sortant attribué par la méthode GetFormulasU dont la propriété est retransmise à l'appelant. Ce dernier doit finalement exécuter la procédure SafeArrayDestroy sur le tableau renvoyé. Notez que la procédure SafeArrayDestroy a pour effet secondaire d'effacer les variants référencés par les entrées du tableau et donc de désattribuer toute chaîne renvoyée par la méthode GetFormulas. (Microsoft Visual Basic et Visual Basic pour Applications s’en occupent pour vous.) La méthode GetFormulasU échoue si formulaArray() a la valeur Null.

Remarque

À partir de Microsoft Office Visio 2000, vous pouvez utiliser des noms locaux et universels pour vous reporter aux formes, formes de base, documents, pages, lignes, modules complémentaires, cellules, liens hypertexte, styles, polices, raccourcis de formes de base, objets UI et aux calques Visio. Lorsqu'un utilisateur nomme une forme, par exemple, il définit un nom local. À partir de Microsoft Office Visio 2003, la feuille de calcul ShapeSheet affiche uniquement les noms universels des formules et valeurs de cellules. (Dans les versions antérieures, les noms universels n’étaient pas visibles dans l’interface utilisateur.)

Si vous êtes développeur, vous pouvez utiliser les noms universels dans un programme lorsque vous ne voulez pas modifier un nom chaque fois qu'une solution est localisée. Utilisez la méthode GetFormulas pour obtenir plusieurs formules lorsque vous utilisez la syntaxe locale. Utilisez la méthode GetFormulasU pour obtenir plusieurs formules lorsque vous utilisez la syntaxe universelle.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.