Método ShapeContainer.SelectNextShape

Artigo
05/17/2015

Seleciona a forma anterior ou seguinte na ordem da ShapeCollection.

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

Sintaxe

'Declaração
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

Parâmetros

shape
Tipo: Microsoft.VisualBasic.PowerPacks.Shape

O Shape para iniciar a pesquisa com.

forward
Tipo: Boolean

trueMover para frente na ordem; falsePara mover para trás.

wrap
Tipo: Boolean

truePara continuar pesquisando desde a primeira forma na ordem após a última forma é atingida; Caso contrário, false.

Valor de retorno

Tipo: Boolean
true Se uma forma foi habilitada; Caso contrário, false.

Comentários

A ordem inicial é determinada pela ordem em que formas são adicionadas para o ShapeCollection; Você pode alterar a ordem, chamando o SetChildIndex método.

Exemplos

O exemplo a seguir demonstra como usar o GetNextShape e SelectNextShape métodos para usar a guia de teclas para percorrer as formas em um formulário. Este exemplo requer que você tenha pelo menos três RectangleShape controles em um formulário.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.