Partilhar via


Método Shape.AddRows (Visio)

Adiciona o número de linhas especificado a uma seção ShapeSheet em uma posição especificada.

Sintaxe

expression. AddRows( _Section_ , _Row_ , _RowTag_ , _RowCount_ )

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

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Section Obrigatório Integer A seção na qual as linhas devem ser adicionadas.
Linha Obrigatório Integer A posição na qual as linhas devem ser adicionadas.
RowTag Obrigatório Integer O tipo de linhas a adicionar.
RowCount Obrigatório Integer O número de linhas a adicionar.

Valor de retorno

Inteiro

Comentários

Se a seção ShapeSheet não existir, o método AddRows criará uma seção com linhas em branco. Novas células em novas linhas são inicializadas com fórmulas padrão, se aplicável. Caso contrário, um programa deve incluir declarações para definir as fórmulas para as novas células. Ocorrerá um erro se a linha não puder ser adicionada.

A biblioteca de tipos do Visio declara as constantes para RowTag em VisRowIndices.

As constantes de linha declaradas pela biblioteca de tipos do Visio servem como posições de base nas quais uma linha de seção é iniciada. Adicione deslocamentos a essas constantes para especificar a primeira linha e além, por exemplo, visRowFirst +0, visRowFirst +1 e assim por diante. Para adicionar linhas no final de uma seção, passe a constante visRowLast para o argumento Row. O valor retornado é o índice da linha real.

O argumento RowTag especifica o tipo de linhas a adicionar. Passe visTagDefault (0) como o argumento RowTag para gerar um tipo de linha padrão de seção. Marcas explícitas são úteis ao adicionar linhas às seções Geometria, Pontos de Conexão e Controles. Consulte a propriedade RowType para obter descrições de tipos de linha válidos para essas seções. Passar um tipo de linha inválido gera um erro.

Se você tentar adicionar linhas a uma seção Character, Tabs ou Paragraph, ocorrerá um erro.

O método AddRows não pode adicionar linhas nomeadas. Para adicionar linhas nomeadas, use o método AddNamedRow.

Se você adicionar linhas a uma seção que possui linhas nomeáveis (por exemplo, a seção Connection Points ou Controls), o argumento Row será ignorado. Por padrão, linhas nomeadas são nomeadas na ordem adicionada, por exemplo, Linha_1, Linha_2 e assim por diante. A ordem da nomeação é influenciada, no entanto, por qualquer linha existente ou linha excluída anteriormente.

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.