Application.FormatResultEx method (Visio)

根據格式圖片將字串或數字格式化成為字串；使用指定的單位來進行縮放及格式化。 若為日期或時間字串，亦可選擇設定該字串的語言及行事曆類型。

語法

表情。FormatResultEx (StringOrNumber， UnitsIn， UnitsOut， format， LangID， CalendarID)

expression 代表 Application 物件的變數。

參數

名稱	必要/選用	資料類型	描述
弦或編號	必要	Variant	要格式化的字串或數字；可以傳遞為字串、浮點數或整數。
單位	必要	Variant	歸類至 StringOrNumber 所用的度量單位。
單位退役	必要	Variant	表示結果所用的度量單位。
Format	必要	字串	結果字串外觀的圖片。
LangID	選用	Long	用於結果字串的語言。
CalendarID	選用	Long	用來表示結果串的日曆。 預設數值為西方曆法， visCalWestern。

傳回值

字串

註解

如果是以字串的形式傳遞，則 StringOrNumber 可能是儲存格的公式或預期的公式，或是以字串表示之儲存格的結果或預期結果。 FormatResultEx 方法會評估此字串，並格式化所產生的結果。 由於此字串是在特定儲存格的公式內容之外進行評估，所以如果此字串有包含任何儲存格參考，則 FormatResultEx 方法會傳回錯誤。

StringOrNumber 可能的值包括：

• 1.7
• 3
• "2.5"
• "4.1 cm"
• "12 ft - 17 in + (12 cm / SQRT(7))"

當 UnitsIn 是 visDate 時，你可以將一個數值傳給 StringOrNumber 中的 DATETIME 函式。 你通過的數值的整數部分應代表自1899年12月30日以來的天數，小數部分則代表自午夜以來的一天分數。 例如，38135.50 代表 2004 年 5 月 28 日的中午。

UnitsIn 和 UnitsOut 參數可以是字串，如「英吋」、「英吋」、「內」或「i」。 字串可用於所有支援的 Microsoft Visio 單位，例如公分、公尺、英哩等等。 你也可以使用 VisUnitCodes 中 Visio 類型庫中宣告的任何單位常數。 有效單位列表亦包含於 「關於度量單位」中。

如果 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 自訂的擴展格式日期/時間格式之一，格式為「{{date/time format picture}}」。 你可以在 Visio 的資料格式對話框中的自訂格式框中查看這些格式， (選擇一個形狀，然後在插入標籤中選擇欄位。在類別列表中，選擇日期/時間，然後選擇資料格式) 。

LangID 參數是可選的。 如果你沒指定值，Visio 會使用目前的系統語言。 如果你傳遞一個值， LangID 參數應該是 Windows 用來編碼不同語言版本的標準 ID。 例如，1033 是英語 (美國) 的語言識別碼。 欲查看可能的語言 ID 清單，請參閱 語言識別符常數與字串。

CalendarID 參數應為以下值之一，這些值會在 Visio 類型庫的 VisCellVals 中宣告。 預設數值為西方曆法， visCalWestern。

常數	值	描述
visCalWestern	0	西方的
visCalArabicHijri	1	阿拉伯回曆
visCalHebrew月球	2	希伯來陰曆
visCalChineseTaiwan	3	中華民國曆
日本天皇	4	日本天皇曆
visCal泰國佛教	5	泰曆
visCalKoreanDanki	6	朝鮮檀紀曆
visCalSakaEra	7	塞迦曆
visCalTransliteEnglish	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 支援與意見反應。