Método InvisibleApp.FormatResultEx (Visio)

Convierte una cadena o un número en una cadena de acuerdo con una imagen de formato, utilizando las unidades especificadas para el ajuste de escala y el formato. Opcionalmente, establece el idioma y el tipo de calendario de las cadenas de fecha u hora.

Sintaxis

expresión. FormatResultEx (StringOrNumber, UnitsIn, UnitsOut, Format, LangID, CalendarID)

Expresión Variable que representa un objeto InvisibleApp .

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
StringOrNumber	Obligatorio	Variant	Cadena o número al que se va a dar formato; se puede pasar como una cadena, un número de punto flotante o un entero.
UnitsIn	Obligatorio	Variant	Unidades de medida en que se supone que está StringOrNumber.
UnitsOut	Obligatorio	Variant	Unidades de medida en las que se expresará el resultado.
Format	Obligatorio	String	Imagen que muestra el aspecto que debería tener la cadena resultante.
LangID	Opcional	Long	Idioma que se va a utilizar para la cadena resultante.
CalendarID	Opcional	Long	Calendario que se va a utilizar para la cadena resultante. El valor predeterminado es el calendario occidental, visCalWestern.

Valor devuelto

Cadena

Comentarios

Si se pasa como cadena, StringOrNumber puede ser la fórmula o la posible fórmula de una celda, o el resultado o el posible resultado de una celda expresado en forma de cadena. El método FormatResultEx evalúa la cadena y da formato al resultado. Dado que la cadena se está evaluando fuera del contexto de fórmula de una celda determinada, el método FormatResultEx devuelve un error si la cadena contiene alguna referencia a celdas.

Algunos valores posibles para StringOrNumber son:

• 1.7
• 3
• "2.5"
• "4,1 cm"
• "12 pies - 17 pda + (12 cm / SQRT(7))"

Cuando UnitsIn es visDate, puede pasar un valor numérico a la función DATETIME de StringOrNumber. La parte entera del valor que se pasa debe representar el número de días desde el 30 de diciembre de 1899 y la parte decimal debe representar la fracción de un día desde medianoche. Por ejemplo, 38135.50 representa el mediodía del 28 de mayo de 2004.

Los argumentos UnitsIn y UnitsOut pueden ser cadenas como "pulgadas", "pulgada", "in", o "i". Las cadenas se pueden usar para todas las unidades admitidas de Microsoft Visio, como centímetros, metros, millas, etc. También puede usar cualquiera de las constantes de unidad declaradas por la biblioteca de tipos de Visio en VisUnitCodes. También se incluye una lista de unidades válidas en Acerca de las unidades de medida.

Si StringOrNumber es una cadena, UnitsIn especifica cómo interpretar el resultado y sólo se usará si dicho resultado es un escalar. Por ejemplo, la expresión "4 * 5 cm" se evalúa como 20 cm, que no es escalar, por lo que UnitsIn se omite. La expresión "4 * 5" se evalúa como 20, que es escalar y se interpreta mediante el uso de unitsIn especificado.

El argumento UnitsOut especifica las unidades en las que se debe expresar la cadena devuelta. Si desea expresar el resultado en las mismas unidades que la expresión evaluada, pase "NOCAST" o visNoCast.

Format es una cadena que especifica una plantilla o una imagen de la cadena producida por el método FormatResultEx. Para obtener más detalles, la función FORMAT. Algunas de las posibilidades son:

• # - Genera un solo dígito, pero no si es un 0 inicial o final.

• 0 - Genera un solo dígito, incluso si es un 0 inicial o final.

• . - Marcador de posición decimal.

• , - Separador de miles.

• "text" o 'text' bien: salida de texto entrelazado tal como está.

• \c - Salida del carácter c.

Cuando UnitsIn es visDate, Format debe ser uno de los formatos personalizados de fecha y hora de formulario expandido de Microsoft Visio, que tienen el formato "{{date/time format picture}}". Puede ver estos formatos en el cuadro Formato personalizado del cuadro de diálogo Formato de datos de Visio (seleccione una forma y, a continuación, en la pestaña Insertar , elija Campo. En la lista Categoría , elija Fecha y hora y, a continuación, elija Formato de datos).

El argumento LangID es opcional. Si no especifica ningún valor, Visio utiliza el idioma actual del sistema. Si pasa un valor, el argumento LangID debe ser uno de los identificadores estándar que usa Windows para codificar versiones de lenguaje diferentes. Por ejemplo, 1033 es el identificador de idioma para el inglés (Estados Unidos). Para ver una lista de los posibles identificadores de idioma, consulte Constantes y cadenas de identificador de idioma.

El argumento CalendarID debe ser uno de los siguientes valores, que se declaran en VisCellVals en la biblioteca de tipos de Visio. El valor predeterminado es el calendario occidental, visCalWestern.

Constante	Valor	Descripción
visCalWestern	0	Occidental
visCalArabicHijri	1	Hijiri árabe
visCalHebrewLunar	2	Hebreo lunar
visCalChineseTaiwan	3	Calendario taiwanés
visCalJapaneseEmperor	4	Japonés imperial
visCalThaiBuddhism	5	Budista tailandés
visCalKoreanDanki	6	Danki coreano
visCalSakaEra	7	Saka
visCalTranslitEnglish	8	Transliteración al inglés
visCalTranslitFrench	9	Transliteración al francés

Ejemplo:

En el ejemplo siguiente se muestra cómo usar la propiedad FormatResultEx para dar formato a una fecha en griego y mostrarla como texto de forma.

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

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.