ShapeContainer.SelectNextShape, méthode

Article
05/16/2015

Sélectionne la forme suivante ou précédente dans l'ordre de la ShapeCollection.

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

Syntaxe

'Déclaration
Public Function SelectNextShape ( _
    shape As Shape, _
    forward As Boolean, _
    wrap As Boolean _
) As Boolean

public bool SelectNextShape(
    Shape shape,
    bool forward,
    bool wrap
)

public:
bool SelectNextShape(
    Shape^ shape, 
    bool forward, 
    bool wrap
)

member SelectNextShape : 
        shape:Shape * 
        forward:bool * 
        wrap:bool -> bool

public function SelectNextShape(
    shape : Shape, 
    forward : boolean, 
    wrap : boolean
) : boolean

Paramètres

shape
Type : Microsoft.VisualBasic.PowerPacks.Shape

Shape à partir duquel commencer la recherche.

forward
Type : Boolean

true pour avancer dans l'ordre ; false pour reculer.

wrap
Type : Boolean

true pour poursuivre la recherche à partir de la première forme dans l'ordre après que le dernière forme a été atteinte ; sinon, false.

Valeur de retour

Type : Boolean
true si une forme a été activée ; sinon, false.

Notes

La commande initiale est déterminée par l'ordre dans lequel les formes sont ajoutées à ShapeCollection; vous pouvez modifier cet ordre en appelant la méthode de SetChildIndex.

Exemples

L'exemple suivant montre comment utiliser l'GetNextShape et les méthodes de SelectNextShape pour utiliser la touche TAB pour vous déplacer dans les formes dans un formulaire. Cet exemple requiert que vous avez au moins trois contrôles d'RectangleShape sur un formulaire.

Private Sub Shapes_PreviewKeyDown(
    ByVal sender As Object, 
    ByVal e As System.Windows.Forms.PreviewKeyDownEventArgs
  ) Handles RectangleShape1.PreviewKeyDown, 
            RectangleShape2.PreviewKeyDown, 
            RectangleShape3.PreviewKeyDown

    Dim sh As Shape
    ' Check for the TAB key. 
    If e.KeyCode = Keys.Tab Then 
        ' Find the next shape in the order.
        sh = ShapeContainer1.GetNextShape(sender, True)
        ' Select the next shape.
        ShapeContainer1.SelectNextShape(sender, True, True)
    End If 
End Sub

private void Shapes_PreviewKeyDown(object sender, 
    System.Windows.Forms.PreviewKeyDownEventArgs e)
{
    Shape sh;
    // Check for the TAB key. 
    if (e.KeyCode==Keys.Tab)
        // Find the next shape in the order.
    {
        sh = shapeContainer1.GetNextShape((Shape) sender, true);
        // Select the next shape.
        shapeContainer1.SelectNextShape((Shape) sender, true, 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.