Shape.Parent, propriété

Mise à jour : novembre 2007

Obtient ou définit le conteneur parent d'un contrôle Shape ou Line.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

<BrowsableAttribute(False)> _
Public Property Parent As ShapeContainer

Dim instance As Shape
Dim value As ShapeContainer

value = instance.Parent

instance.Parent = value

[BrowsableAttribute(false)]
public ShapeContainer Parent { get; set; }

[BrowsableAttribute(false)]
public:
property ShapeContainer^ Parent {
    ShapeContainer^ get ();
    void set (ShapeContainer^ value);
}

public function get Parent () : ShapeContainer
public function set Parent (value : ShapeContainer)

Valeur de propriété

Type : Microsoft.VisualBasic.PowerPacks.ShapeContainer

ShapeContainer qui représente le parent ou le conteneur du contrôle.

Notes

Un contrôle LineShape, OvalShape ou RectangleShape peut uniquement être contenu dans un objet ShapeContainer, qui sert de zone de dessin pour les contrôles Line et Shape.

Lorsque vous ajoutez une ligne ou une forme à un formulaire ou un conteneur au moment du design, un ShapeContainer est automatiquement créé s'il n'en existe pas encore. La propriété Parent de la ligne ou de la forme est définie sur celle du ShapeContainer. La propriété Parent du ShapeContainer prend la valeur du contrôle de formulaire ou conteneur auquel la ligne ou la forme a été ajoutée.

Lorsque vous créez une ligne ou une forme au moment de l'exécution à l'aide de la méthode New, vous devez définir sa propriété Parent sur un ShapeContainer. Si un ShapeContainer existe déjà pour le formulaire ou le conteneur, vous devez définir la propriété Parent sur celle de ShapeContainer. Si aucun ShapeContainer n'existe, vous pouvez créer un ShapeContainer en utilisant la méthode New et définir sa propriété Parent sur le formulaire ou le conteneur.

Remarque :
Ne créez pas plusieurs ShapeContainer pour un formulaire ou conteneur car cela pourrait entraîner un comportement inattendu. Si vous ajoutez un contrôle Line ou Shape à un formulaire ou un conteneur au moment du design après avoir écrit un code pour en créer un par programme, vous devez modifier ce code pour utiliser le ShapeContainer créé par le concepteur.

Exemples

L'exemple suivant vérifie si un ShapeContainer existe et définit la propriété Parent d'un contrôle OvalShape créé au moment de l'exécution à l'aide de la méthode New.

Dim NewOval As New OvalShape
Dim i As Integer
Dim found As Boolean
' Loop through the Controls collection.
For i = 0 To Me.Controls.Count - 1
    ' If a ShapeContainer is found, make it the parent.
    If TypeOf Controls.Item(i) Is ShapeContainer Then
        NewOval.Parent = Controls.Item(i)
        found = True
        Exit For
    End If
Next
' If no ShapeContainer is found, create one and set the parents.
If found = False Then
    Dim sc As New ShapeContainer
    sc.Parent = Me
    NewOval.Parent = sc
End If
NewOval.Size = New Size(200, 300)

OvalShape NewOval = new OvalShape();
int i;
bool found = false;
// Loop through the Controls collection.
for (i = 0; i < this.Controls.Count; i++)
{
    // If a ShapeContainer is found, make it the parent.
    if (this.Controls[i] is ShapeContainer)
    {
        NewOval.Parent = ((ShapeContainer)Controls[i]);
        found = true;
        break;
    }
}
// If no ShapeContainer is found, create one and set the parents.
if (found == false)
{
    ShapeContainer sc = new ShapeContainer();
    sc.Parent = this;
    NewOval.Parent = sc;
}
NewOval.Size = new Size(200, 300);
found = true;

Autorisations

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.