Partager via


Shape.AddRows, méthode (Visio)

Ajoute le nombre de lignes spécifié à une section de la feuille ShapeSheet, à la position indiquée.

Syntaxe

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

Expression Variable qui représente un objet Shape .

Parameters

Nom Requis/Facultatif Type de données Description
Section Obligatoire Integer Section dans laquelle ajouter les lignes.
Ligne Obligatoire Integer Position à laquelle ajouter les lignes.
RowTag Requis Integer Type de lignes à ajouter.
RowCount Requis Integer Nombre de lignes à ajouter.

Valeur renvoyée

Entier

Remarques

Si la section de la feuille ShapeSheet n'existe pas, la méthode AddRows crée une section qui comporte des lignes vides. Les cellules des nouvelles lignes sont initialisées à l'aide de formules par défaut, si nécessaire. Dans le cas contraire, un programme doit inclure des instructions pour définir les formules des nouvelles cellules. Une erreur se produit si la ligne ne peut pas être ajoutée.

La bibliothèque de types Visio déclare les constantes pour BaliseLigne dans VisRowIndices.

Les constantes de ligne déclarées par la bibliothèque de types Visio servent de positions de base à partir des lignes d’une section. Ajoutez des décalages à ces constantes pour spécifier la première ligne et au-delà, par exemple visRowFirst +0, visRowFirst +1, etc. Pour ajouter des lignes à la fin d’une section, passez la constante visRowLast pour l’argument Row . La valeur retournée est l’index de ligne réel.

L'argument BaliseLigne indique le type de ligne à ajouter. Pour générer le type de ligne par défaut d'une section, transmettez visTagDefault (0) comme argument BaliseLigne. Les balises explicites sont utiles lors de l'ajout de lignes aux sections Geometry, Connection Points et Controls. Reportez-vous à la propriété RowType pour des descriptions des types de lignes valides pour ces sections. La transmission d'un type de ligne non valide génère une erreur.

Si vous essayez d'ajouter des lignes à une section Character, Tabs ou Paragraph, une erreur se produit.

La méthode AddRows ne peut pas ajouter de lignes nommées. Pour ajouter des lignes nommées, utilisez la méthode AddNamedRow.

Si vous ajoutez des lignes à une section qui a des lignes pouvant être nommées (par exemple, la section Points de connexion ou Contrôles), l’argument Ligne est ignoré. Par défaut, les lignes nommées sont nommées dans l’ordre ajouté, par exemple, Row_1, Row_2, etc. Toutefois, l’ordre de nommage est influencé par les lignes existantes ou les lignes précédemment supprimées.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.