Méthode Selection.DrawRegion (Visio)
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.