Méthode Application.FormatResultEx (Visio)

  • Article

Met en forme une chaîne ou un nombre dans une chaîne selon une image de format, en utilisant les unités indiquées pour la mise à l’échelle et la mise en forme. Facultativement, pour les chaînes de date ou d’heure, définit la langue et le type de calendrier de la chaîne.

Syntaxe

expression. FormatResultEx (StringOrNumber, UnitsIn, UnitsOut, Format, LangID, CalendarID)

expressionUne variable qui représente un objetApplication.

Paramètres

Nom Requis/Facultatif Type de données Description
StringOrNumber Requis Variant Chaîne ou nombre à mettre en forme ; peut être une chaîne, un nombre à virgule flottante ou un entier.
UnitsIn Requis Variant Unités de mesure à attribuer à ChaîneOuNombre.
UnitsOut Requis Variant Unités de mesure dans lesquelles le résultat doit être exprimé.
Format Obligatoire String Aperçu de la chaîne de résultat.
LangID Facultatif Long Langue à utiliser pour la chaîne de résultat.
CalendarID Facultatif Long Calendrier à utiliser pour la chaîne de résultat. La valeur par défaut est le calendrier occidental, visCalWestern.

Valeur renvoyée

Chaîne

Remarques

S'il est transmis sous forme de chaîne, l'argument ChaîneOuNombre peut être soit la formule ou la formule prospective d'une cellule soit le résultat ou le résultat prospectif d'une cellule exprimée sous forme de chaîne. La méthode FormatResultEx calcule la chaîne et met en forme le résultat. Puisque la chaîne est calculée sans être considérée comme la formule d'une cellule particulière, la méthode FormatResultEx renvoie une erreur si la chaîne contient des références à d'autres cellules.

Valeurs pouvant figurer dans ChaîneOuNombre :

  • 1.7
  • 3
  • "2.5"
  • « 4,1 cm »
  • « 12 pd - 17 po + (12 cm / SQRT(7)) »

Lorsque UnitésEntrée est visDate, vous pouvez transmettre une valeur numérique à la fonction DATETIME dans ChaîneOuNombre. La partie entière de la valeur que vous transmettez doit représenter le nombre de jours depuis le 30 décembre 1899, et la partie décimale doit représenter la fraction d’un jour depuis minuit. Par exemple, 38135.50 représente midi le 28 mai 2004.

Les arguments UnitésEntrée et UnitésSortie peuvent être des chaînes telles que « pouces », « pouce », « po » ou « p ». Toutes les unités prises en charge par Microsoft Office Visio, comme le centimètre, le mètre, le mile, etc., peuvent être utilisées. Vous pouvez également utiliser n’importe quelle constante d’unité déclarée par la bibliothèque de types Visio dans VisUnitCodes. Une liste d’unités valides est également incluse dans À propos des unités de mesure.

Si ChaîneOuNombre est une chaîne, l'argument UnitésEntrée indique comment interpréter le résultat calculé, et ce, uniquement si ce dernier est un scalaire. Par exemple, l’expression "4 * 5 cm" prend la valeur 20 cm, ce qui n’est pas un scalaire, de sorte que UnitsIn est ignoré. L’expression "4 * 5" prend la valeur 20, qui est une scalaire et est interprétée à l’aide de la valeur UnitsIn spécifiée.

L'argument UnitésSortie indique les unités de mesure dans lesquelles la chaîne renvoyée doit être exprimée. Si vous souhaitez que les résultats soient exprimés dans les mêmes unités que l'expression calculée, transmettez « NOCAST » ou visNoCast.

Format est une chaîne qui indique un modèle ou une image de la chaîne générée par la méthode FormatResultEx. Pour plus de détails, reportez-vous à la fonction FORMAT. Voici quelques possibilités :

  • # - Sortie d’un seul chiffre, mais pas s’il s’agit d’un début ou d’un 0 de fin.

  • 0 - Sortie d’un seul chiffre, même s’il s’agit d’un 0 de début ou de fin.

  • . - Espace réservé décimal.

  • , - Séparateur de milliers.

  • "text" ou 'text' - Texte joint en sortie tel qu’il est.

  • \c - Sortie du caractère c.

Lorsque UnitsIn a la valeur visDate, Format doit être l’un des formats de date/heure de formulaire développé Microsoft Visio personnalisés, qui sont au format « {{image de format date/heure}} ». Vous pouvez afficher ces formats dans la zone Format personnalisé de la boîte de dialogue Format des données de Visio (sélectionnez une forme, puis, sous l’onglet Insertion , choisissez Champ. Dans la liste Catégorie , choisissez Date/Heure, puis Format de données).

L'argument IDLangue est facultatif. Si vous ne spécifiez pas de valeur, Visio utilise la langue du système actuel. Si vous transmettez une valeur, l’argument LangID doit être l’un des ID standard utilisés par Windows pour encoder différentes versions de langage. Par exemple, 1033 est l'ID de langue pour l'anglais (États-Unis). Pour afficher la liste des ID de langue possibles, consultez Constantes et chaînes d’identificateur de langue.

L’argument CalendarID doit être l’une des valeurs suivantes, qui sont déclarées dans VisCellVals dans la bibliothèque de types Visio. La valeur par défaut est le calendrier occidental, visCalWestern.

Constante Valeur Description
visCalWestern 0 Occidentale
visCalArabicHijri 1 Hijri (lunaire arabe)
visCalHebrewLunar 2 Hébreu (lunaire)
visCalChineseTaiwan 3 Taiwanais
visCalJapaneseEmperor 4 Japonais (ère impériale)
visCalThaiB bouddhisme 5 Bouddhiste thaïlandais
visCalKoreanDanki 6 Coréen (Danki)
visCalSakaEra 7 Saka Era
visCalTranslitEnglish 8 Translittéré en anglais
visCalTranslitFrench 9 Translittéré en français

Exemple

L’exemple suivant montre comment utiliser la propriété FormatResultEx pour mettre en forme une date en grec et l’afficher sous forme de texte de forme.

Public Sub FormatResultEx_Example 
 
 Dim vsoShape As Visio.Shape 
 Dim strDate As String 
 
 Set vsoShape = ActivePage.DrawOval (3, 5, 5, 9) 
 strDate = Application.FormatResultEx (37663.50, visDate, "", "{{dd MMMM yyyy}}", 1032, 0) 
 
 vsoShape.Text = strDate 
 
End Sub

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.