Metodo ShapeContainer.GetNextShape

Articolo
05/16/2015

Recupera la forma precedente o successiva nell'ordine di ShapeCollection.

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

'Dichiarazione
Public Function GetNextShape ( _
    shape As Shape, _
    forward As Boolean _
) As Shape

public Shape GetNextShape(
    Shape shape,
    bool forward
)

public:
Shape^ GetNextShape(
    Shape^ shape, 
    bool forward
)

member GetNextShape : 
        shape:Shape * 
        forward:bool -> Shape

public function GetNextShape(
    shape : Shape, 
    forward : boolean
) : Shape

Parametri

shape
Tipo: Microsoft.VisualBasic.PowerPacks.Shape

Controllo Shape con il quale iniziare la ricerca.

forward
Tipo: Boolean

true per eseguire la ricerca in avanti; false per eseguire la ricerca all'indietro.

Valore restituito

Tipo: Microsoft.VisualBasic.PowerPacks.Shape
Oggetto Shape successivo nell'ordine di ShapeCollection.

Note

L'ordine iniziale è determinato dall'ordine in cui le forme vengono aggiunti a ShapeCollection; è possibile modificare l'ordine chiamando il metodo SetChildIndex.

Esempi

Nell'esempio seguente viene illustrato come utilizzare i metodi di SelectNextShape e di GetNextShape per utilizzare il tasto TAB per spostarsi tra le forme in un form. Questo esempio è necessario disporre di almeno tre comandi di RectangleShape in un form.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.