Méthode Selection.DrawRegion (Visio)

  • Article

Dessine une nouvelle forme qui représente la région contenant un point donné.

Syntaxe

expression. DrawRegion( _Tolerance_ , _Flags_ , _x_ , _y_ , _ResultsMaster_ )

Expression Variable qui représente un objet Selection .

Paramètres

Nom Requis/Facultatif Type de données Description
Tolerance Obligatoire Double Tolérance d'erreur lors de la définition de la correspondance des points. Distance exprimée en unités internes dans l'espace de coordonnées de la forme contenant l'objet Selection ; écart maximal toléré entre les chemins lors de la construction des limites d'une région.
Flags Obligatoire Integer Constante ou entier indiquant les modalités de traçage de la région.
x Facultatif Variant Coordonnée X en unités internes dans l'espace de coordonnées de l'objet Selection.
y Facultatif Variant Coordonnée Y en unités internes dans l'espace de coordonnées de l'objet Selection.
ResultsMaster Facultatif Variant Objet Master dont le nouvel objet Shape doit être une instance.

Valeur renvoyée

Shape

Remarques

La méthode DrawRegion crée un nouvel objet Shape à partir des éléments de chemins dans l'objet Selection.

  • Si x et y sont spécifiés, la forme obtenue est la plus petite région qui contient le point ( x, y).

  • En l’absence de x ou y, ou si le point ( x, y) n’est contenu dans aucune région délimitée par les chemins des formes sélectionnées, le résultat est l’union de toutes les formes qui auraient été créées à l’aide de l’opération Fragment .

  • Si aucune région fermée n'est définie par les formes sélectionnées, la méthode DrawRegion renvoie la valeur Nothing sans déclencher d'exception.

L’argument Flags peut être une ou une combinaison des constantes suivantes déclarées par la bibliothèque de types Visio dans VisDrawRegionFlags.

**Nom** Valeur Description
visDrawRegionDeleteInput &H4 Supprime les éléments dans la sélection.
visDrawRegionIgnoreVisible &H20 Exclut la géométrie visible.
visDrawRegionIncludeDataGraphics &H40 Inclut les formes de légende de graphique de données et leurs sous-formes.
visDrawRegionIncludeHidden &H10 Inclut la géométrie masquée.

Si la méthode DrawRegion reçoit un argument FormeDeBaseRésultats de type VT_EMPTY ou VT_ERROR (utilisés dans VBA pour transmettre un argument facultatif indéfini), la nouvelle forme n'est pas une instance de forme de base. Les styles de remplissage, de trait et de texte de la nouvelle région prennent les styles par défaut du document.

Si la méthode DrawRegion reçoit un argument FormeDeBaseRésultats du type VT_UNKNOWN ou VT_DISPATCH faisant référence à un objet Master, la méthode DrawRegion crée une instance de cet objet Master et calcule la figure géométrique à partir de l'objet Selection.

Le nouvel objet Shape contient uniquement le texte déjà présent dans FormeDeBaseRésultats.

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.