Shape.Parent, propriété

Article
11/15/2012

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

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

Syntaxe

'Déclaration
<BrowsableAttribute(False)> _
Public Property Parent As ShapeContainer

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

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

[<BrowsableAttribute(false)>]
member Parent : ShapeContainer with get, set

function get Parent () : ShapeContainer
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

LineShape, OvalShape, ou le contrôle d'RectangleShape peuvent être contenus uniquement dans un objet d'ShapeContainer, qui sert de canvas pour des contrôles Line et Shape.

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

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

[!REMARQUE]

Ne créez pas plusieurs ShapeContainer pour chaque formulaire ou conteneur ; cela peut entraîner le comportement inattendu.Si vous ajoutez un contrôle Line ou Shape au moment du design à un formulaire ou à un conteneur après écrivant code pour créer un par programme, vous modifiez ce code pour utiliser ShapeContainer créé par le générateur.

Exemples

L'exemple suivant vérifie ShapeContainer existant et définit la propriété d'Parent d'un contrôle d'OvalShape qui a été créé pendant l'exécution à l'aide de la méthode d'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;

Sécurité .NET Framework

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.