ShapeContainer.SelectNextShape-Methode

Artikel
10/24/2012

Wählt die nächste oder vorherige Formular in der Reihenfolge ShapeCollectionaus.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
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

Parameter

shape
Typ: Microsoft.VisualBasic.PowerPacks.Shape
Das Shape, mit dem die Suche begonnen werden soll.

forward
Typ: System.Boolean
true , um vorwärts in der Reihenfolge zu verschieben. false , um rückwärts zu verschieben.

wrap
Typ: System.Boolean
true , an dem die Suche in der ersten Form in der Reihenfolge nach der letzten Form erreicht wird fortgesetzt. andernfalls false.

Rückgabewert

Typ: System.Boolean
true , wenn eine Form aktiviert wurde. andernfalls false.

Hinweise

Die ursprüngliche Reihenfolge wird durch die Reihenfolge bestimmt, in der ShapeCollectionForms hinzugefügt werden. Sie können die Reihenfolge ändern, indem Sie die SetChildIndex-Methode aufrufen.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie das GetNextShape und die SelectNextShape-Methode verwendet, um die TAB-Taste, um sich durch die Formen auf einem Formular zu navigieren.Dieses Beispiel setzt voraus, dass Sie mindestens drei RectangleShape-Steuerelementen auf einem Formular verfügen.

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);
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.