Shape.Parent, propriété

Article
05/16/2015

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

Un LineShape, OvalShape, ou RectangleShape contrôle peut être contenue uniquement dans un ShapeContainer objet, qui agit comme une 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'existe pas. Le Parent de la ligne ou la forme est définie sur qui ShapeContainer. Le Parent propriété de la ShapeContainer est défini sur le contrôle de formulaire ou un conteneur dans lequel la ligne ou la forme a été ajoutée.

Lorsque vous créez d'une ligne ou une forme au moment de l'exécution à l'aide de la New (méthode), vous devez définir son Parent propriété à un ShapeContainer. Si un ShapeContainer existe déjà pour le formulaire ou un conteneur, vous devez définir le Parent propriété qui ShapeContainer. Si aucun ShapeContainer existe, vous pouvez créer un ShapeContainer à l'aide de la New méthode et définissez son Parent propriété vers le formulaire ou un conteneur.

Notes

Ne créez pas plusieurs ShapeContainer pour chaque formulaire ou un conteneur ; Cela peut entraîner un comportement inattendu.Si vous ajoutez une ligne au moment du design ou un contrôle shape à un formulaire ou un conteneur après l'écriture de 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 recherche une existante ShapeContainer et définit les Parent propriété d'un OvalShape contrôle a été créé au moment de l'exécution à l'aide de la New (méthode).

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, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.