Método Style.GetFormulasU (Visio)

  • Artigo

Retorna as fórmulas de várias células.

Sintaxe

expression. GetFormulasU( _SRCStream()_ , _formulaArray()_ )

Expressão Uma variável que representa um objeto Style .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
SRCStream() Obrigatório Integer Um fluxo que identifica as células a serem consultadas.
formulaArray() Obrigatório Variantes Parâmetro externo. Uma matriz que recebe as fórmulas das células consultadas.

Valor de retorno

Nada

Comentários

O método GetFormulasU é como a propriedade FormulaU de um objeto Cell, exceto que você pode usá-lo para obter as fórmulas de várias células de uma vez, em vez de uma célula por vez. O método GetFormulasU é uma especialização do método GetResults, que pode ser usado para obter resultados ou fórmulas de células. Configurar uma chamada para o método GetFormulasU envolve um pouco menos de trabalho que configurar o método GetResults.

Use o método GetFormulasU para obter fórmulas de qualquer conjunto de células.

SRCStream() é uma matriz de números inteiros de 2 bytes. Para objetos Style , sRCStream() deve ser uma matriz unidimensional de 3 n 2 bytes inteiros para alguns n>= 1. GetFormulasU interpreta o fluxo como:

{sectionIdx, rowIdx, cellIdx}n

onde sectionIdx é o índice da seção da célula desejada, rowIdx é seu índice de linha e cellIdx é seu índice de célula.

Se o método GetFormulasU obtiver êxito, formulaArray() retornará uma matriz unidimensional com n variantes indexadas de 0 a n - 1. Cada variante retorna uma fórmula como uma sequência de caracteres. formulaArray() é um parâmetro externo alocado pelo método GetFormulasU, que passa a propriedade de volta ao chamador. Por fim, o chamador deve executar o procedimento SafeArrayDestroy na matriz retornada. Observe que o procedimento SafeArrayDestroy tem o efeito colateral de limpar as variantes referenciadas pelas entradas da matriz, desfazendo assim a alocação as sequências de caracteres que o método GetFormulas retorna. (Microsoft Visual Basic e Microsoft Visual Basic for Applications cuidar disso para você.) O método GetFormulasU falhará se formulaArray() for Null.

Observação

A partir do Microsoft Visio 2000, você pode usar nomes locais e universais para se referir a formas, mestres, documentos, páginas, linhas, complementos, células, hiperlinks, estilos, fontes, atalhos mestre, objetos UI e camadas do Visio. Quando um usuário nomeia uma forma, por exemplo, o usuário está especificando um nome local. A partir do Microsoft Office Visio 2003, a planilha ShapeSheet exibe apenas nomes universais em fórmulas de células e valores. (Em versões anteriores, os nomes universais não eram visíveis na interface do usuário.).

Como desenvolvedor, você poderá usar nomes universais em um programa quando não quiser alterar um nome a cada vez que uma solução for localizada. Use o método GetFormulas para obter mais de uma fórmula ao usar a sintaxe local. Use o método GetFormulasU para obter mais de uma fórmula ao usar a sintaxe universal.

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.