Método Characters.AddFieldEx (Visio)
Reemplaza el texto representado por un objeto Characters por un nuevo campo de la categoría, el código, el formato, el identificador de idioma y el identificador de calendario que especifique.
Sintaxis
expresión. AddFieldEx (Category, Code, Format, LangID, CalendarID)
Expresión Variable que representa un objeto Characters .
Parameters
| Nombre | Obligatorio/opcional | Tipo de datos | Descripción |
|---|---|---|---|
| Categoría | Obligatorio | VisFieldCategories | Categoría del nuevo campo. |
| Código | Obligatorio | VisFieldCodes | Código del nuevo campo. |
| Format | Obligatorio | VisFieldFormats | Formato del nuevo campo. |
| LangID | Opcional | Long | Idioma que se va a usar para el nuevo campo. |
| CalendarID | Opcional | Long | Calendario que se va a utilizar para el nuevo campo. |
Valor devuelto
Nothing
Comentarios
Los valores constantes de Category, Code y Format los declara la biblioteca de tipos de Visio en VisFieldCategories, VisFieldCodes y VisFieldFormats , respectivamente.
El argumento LangID debe ser uno de los identificadores estándar que usa Windows para codificar versiones de lenguaje diferentes. Por ejemplo, el identificador de idioma es &H0409 para la versión de Microsoft Visio en inglés de Estados Unidos. Para ver una lista de los posibles identificadores de idioma, busque "VERSIONINFO" en el SDK de la plataforma de Microsoft en MSDN.
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 visCalWestern, que establece el calendario en el calendario occidental.
| 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 |
Usar el método AddFieldEx es similar a hacer clic en Campo en la ficha Insertar e insertar cualquiera de las siguientes categorías de campo en el texto:
Fecha y hora
Información del documento
Geometría
Información del objeto
Información de página
Para agregar un campo de fórmula personalizado, use el método AddCustomField o AddCustomFieldU . Cuando no se pasan valores (o se pasan valores predeterminados) para los argumentos opcionales LangID y CalendarID , AddFieldEx actúa exactamente igual que AddField.
Ejemplo
La siguiente macro de Microsoft Visual Basic para Aplicaciones (VBA) muestra cómo utilizar la propiedad AddFieldEx para aplicar formato a un campo de fecha en una forma. Dibuja un rectángulo en la página de dibujo y, a continuación, inserta un campo que muestra la fecha actual en griego, utilizando el calendario occidental.
Public Sub AddFieldEx_Example()
Dim vsoCharacters As Visio.Characters
Dim vsoShape As Visio.Shape
ActiveWindow.DeselectAll
Set vsoShape = Application.ActivePage.DrawRectangle(3, 5, 5, 3)
vsoShape.Text = "Date: "
Set vsoCharacters = vsoShape.Characters
'Set Begin property equal to End property to
'append new text to existing text.
vsoCharacters.Begin = vsoCharacters.End
'Add a field for the current date, in Greek,
'using the Western calendar and the long date format.
vsoCharacters.AddFieldEx visFCatDateTime, visFCodeCurrentDate, visFmtMsoDateLong, 1032, visCalWestern
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.