Método Application.FormatResultEx (Visio)
Formata uma sequência de caracteres ou número em uma sequência de caracteres de acordo com uma imagem de formatação, usando unidades especificadas para colocação em escala e formatação. Opcionalmente, para sequências de caracteres de data ou hora, define o idioma e tipo de calendário da sequência de caracteres.
Sintaxe
expressão. FormatResultEx (StringOrNumber, UnitsIn, UnitsOut, Format, LangID, CalendarID)
expressão Uma variável que representa um Aplicativo objeto.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| StringOrNumber | Obrigatório | Variantes | Sequência de caracteres ou número a ser formatado; pode ser passado como uma sequência de caracteres, número com ponto flutuante ou número inteiro. |
| UnitsIn | Obrigatório | Variantes | Unidades de medida para atribuir a StringOrNumber. |
| UnitsOut | Obrigatório | Variantes | Unidades de medida para expressar o resultado. |
| Format | Obrigatório | String | Imagem da aparência que a sequência de caracteres resultante deve ter. |
| LangID | Opcional | Long | O idioma a ser usado para a sequência de caracteres resultante. |
| CalendarID | Opcional | Long | O calendário a ser usado para a sequência de caracteres resultante. O valor padrão é o calendário ocidental, visCalWestern. |
Valor de retorno
Cadeia de caracteres
Comentários
Se passado como uma sequência de caracteres, StringOrNumber deve ser a fórmula ou fórmula prospectiva de uma célula, ou o resultado ou resultado prospectivo de uma célula expresso como uma sequência de caracteres. O método FormatResultEx avalia a sequência de caracteres e formata o resultado. Como a sequência de caracteres está sendo avaliada fora do contexto de ser a fórmula de uma determinada célula, o método FormatResultEx retornará um erro se a sequência de caracteres contiver qualquer referência a células.
Os valores possíveis de StringOrNumber incluem:
- 1.7
- 3
- "2.5"
- "4,1 cm"
- "12 pés - 17 pol + (12 cm / SQRT(7))"
Quando UnitsIn for visDate, você poderá passar um valor numérico para a função DATETIME em StringOrNumber. A parte inteiro do valor que você passa deve representar o número de dias desde 30 de dezembro de 1899 e a parte decimal deve representar a fração de um dia desde a meia-noite. Por exemplo, 38135.50 representa o meio-dia de 28 de maio de 2004.
Os argumentos UnitsIn e UnitsOut podem ser sequências de caracteres como "polegadas", "polegada", "pol." ou "p". As sequências de caracteres podem ser usadas para todas as unidades do Microsoft Visio com suporte, como centímetros, metros, milhas e assim por diante. Você também pode usar qualquer uma das constantes de unidade declaradas pela biblioteca de tipos do Visio no VisUnitCodes. Uma lista de unidades válidas também está incluída em Sobre unidades de medida.
Se StringOrNumber for uma sequência de caracteres, UnitsIn especificará como interpretar o resultado avaliado e será usado apenas se o resultado for escalar. Por exemplo, a expressão "4 * 5 cm" é avaliada como 20 cm, o que não é um escalar, portanto , UnitsIn é ignorado. A expressão "4 * 5" é avaliada como 20, que é um escalar e é interpretada usando o UnitsIn especificado.
O argumento UnitsOut especifica as unidades nas quais a sequência de caracteres retornada deve ser expressa. Se desejar que os resultados sejam expressos nas mesmas unidades que a expressão avaliada, passe "NOCAST" ou visNoCast.
Format é uma sequência de caracteres que especifica um modelo ou imagem da sequência de caracteres produzida pelo método FormatResultEx. Para obter detalhes, consulte a função FORMAT. Algumas possibilidades são:
#- Saída de um único dígito, mas não se for um 0 à frente ou à direita.0- Saída de um único dígito, mesmo que seja um 0 à frente ou à direita..- Espaço reservado decimal.,Milhares separadores."text"ou'text'– Saída de texto fechado como está.\c- Saída do caractere c.
Quando UnitsIn for visDate, Format deve ser um dos formatos personalizados de data/hora de formulário expandido do Microsoft Visio, que são do formulário "{{imagem de formato de data/hora}}". Você pode exibir esses formatos na caixa Formato Personalizado na caixa de diálogo Formato de Dados no Visio (selecione uma forma e, na guia Inserir , escolha Campo. Na lista Categoria , escolha Data/Hora e escolha Formato de Dados).
O argumento LangID é opcional. Se você não especificar um valor, o Visio utilizará o idioma atual do sistema. Se você passar um valor, o argumento LangID deve ser uma das IDs padrão usadas pelo Windows para codificar diferentes versões de idioma. Por exemplo, 1033 é a identificação de idioma de Inglês (Estados Unidos). Para ver uma lista de possíveis IDs de idioma, consulte Constantes e Cadeias de Caracteres do Identificador de Idioma.
O argumento CalendarID deve ser um dos seguintes valores, que são declarados no VisCellVals na biblioteca de tipos do Visio. O valor padrão é o calendário ocidental, visCalWestern.
| Constant | Valor | Descrição |
|---|---|---|
| visCalWestern | 0 | Ocidental |
| visCalArabicHijri | 1 | Islâmico árabe |
| visCalHebrewLunar | 2 | Lunar hebraico |
| visCalChineseTaiwan | 3 | Calendário de Taiwan |
| visCalJapaneseEmperor | 4 | Reinado do imperador japonês |
| visCalThaiBuddhism | 5 | Budista tailandês |
| visCalKoreanDanki | 6 | Danki coreano |
| visCalSakaEra | 7 | Era Saka |
| visCalTranslitEnglish | 8 | Transliteração inglesa |
| visCalTranslitFrench | 9 | Transliteração francesa |
Exemplo
O exemplo a seguir mostra como usar a propriedade FormatResultEx para formatar uma data em grego e exibi-la 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
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.