Метод InvisibleApp.FormatResultEx (Visio)

  • Статья

Форматирует строку или число в строку в соответствии с рисунком формата, используя указанные единицы для масштабирования и форматирования. При необходимости для строк даты или времени задает язык и тип календаря строки.

Синтаксис

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

Выражение Переменная, представляющая объект InvisibleApp .

Параметры

Имя Обязательный или необязательный Тип данных Описание
StringOrNumber Обязательный Variant Строка или число для форматирования; может передаваться в виде строки, числа с плавающей запятой или целого числа.
UnitsIn Обязательный Variant Единицы измерения для атрибута StringOrNumber.
UnitsOut Обязательный Variant Единицы измерения для выражения результата.
Format Обязательный String Изображение того, как должна выглядеть результющая строка.
LangID Необязательный Long Язык, используемый для строки результата.
CalendarID Необязательный Long он календарь, используемый для строки результата. Значение по умолчанию — западный календарь visCalWestern.

Возвращаемое значение

Строка

Замечания

При передаче в виде строки StringOrNumber может быть формулой или потенциальной формулой ячейки или результатом или потенциальным результатом ячейки, выраженным в виде строки. Метод FormatResultEx вычисляет строку и форматирует результат. Так как строка вычисляется вне контекста, являющегося формулой определенной ячейки, метод FormatResultEx возвращает ошибку, если строка содержит ссылки на ячейки.

Возможные значения для StringOrNumber :

  • 1.7
  • 3
  • "2.5"
  • "4,1 см"
  • "12 футов - 17 дюймов + (12 см / SQRT(7))"

Если элемент UnitsIn имеет visDate, можно передать числовое значение в функцию DATETIME в StringOrNumber. Целочисленная часть передаваемого значения должна представлять количество дней с 30 декабря 1899 г., а десятичная часть должна представлять долю дня с полуночи. Например, 38135.50 представляет полдень 28 мая 2004 года.

Аргументы UnitsIn и UnitsOut могут быть такими строками, как "inches", "inch", "in." или "i". Строки можно использовать для всех поддерживаемых единиц Microsoft Visio, таких как сантиметры, метры, мили и т. д. Вы также можете использовать любую из констант единиц, объявленную библиотекой типов Visio в VisUnitCodes. Список допустимых единиц также включен в сведения о единицах измерения.

Если StringOrNumber является строкой, UnitsIn указывает способ интерпретации вычисленного результата и используется только в том случае, если результат является скалярным. Например, выражение "4 * 5 cm" оценивается в 20 см, что не является скалярным, поэтому UnitsIn игнорируется. Выражение "4 * 5" имеет значение 20, которое является скалярным и интерпретируется с помощью указанного элемента UnitsIn.

Аргумент UnitsOut указывает единицы измерения, в которых должна быть выражена возвращаемая строка. Если вы хотите, чтобы результаты были выражены в той же единице, что и вычисляемого выражения, передайте "NOCAST" или visNoCast.

Format — это строка, указывающая шаблон или рисунок строки, созданной методом FormatResultEx . Дополнительные сведения см. в функции FORMAT. Ниже приведены некоторые возможности.

  • # — выводит однозначную цифру, но не, если она является начальным или конечным значением 0.

  • 0 — выводит одну цифру, даже если она является начальным или конечным 0.

  • . — Заполнитель десятичного разряда.

  • , — Разделитель тысяч.

  • "text" или 'text' — выводит вложенный текст как есть.

  • \c — выводит символ c.

Если элемент UnitsIn имеет значение visDate, формат должен быть одним из настраиваемых форматов даты и времени в расширенной форме Microsoft Visio, которые имеют форму "{{рисунок формата даты и времени}}". Эти форматы можно просмотреть в поле Настраиваемый формат в диалоговом окне Формат данных в Visio (выберите фигуру, а затем на вкладке Вставка выберите Поле. В списке Категория выберите Дата и время, а затем — Формат данных).

Аргумент LangID необязателен. Если не указать значение, Visio использует текущий системный язык. Если вы передаете значение, аргумент LangID должен быть одним из стандартных идентификаторов, используемых Windows для кодирования различных языковых версий. Например, 1033 — это идентификатор языка для английского языка (США). Список возможных идентификаторов языка см. в статье Константы и строки идентификатора языка.

Аргумент CalendarID должен быть одним из следующих значений, объявленных в VisCellVals в библиотеке типов Visio. Значение по умолчанию — западный календарь visCalWestern.

Константа Значение Описание
visCalWestern 0 Западной
visCalArabicHijri 1 Арабский хидзири
visCalHebrewLunar 2 Иврит лунный
visCalChineseTaiwan 3 Календарь Тайваня
visCalJapaneseEmperor 4 Царствование японского императора
visCalThaiBuddhism 5 Тайский буддийский
visCalKoreanDanki 6 Корейский Danki
visCalSakaEra 7 Эра Сака
visCalTranslitEnglish 8 Транслитерация английского языка
visCalTranslitFrench 9 Транслитерация французского языка

Пример

В следующем примере показано, как использовать свойство FormatResultEx для форматирования даты на греческом языке и отображения ее в виде текста фигуры.

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

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.