Método DataRepeater.ScrollItemIntoView (Int32, Boolean)

Artigo
10/26/2012

Rola um especificado DataRepeaterItem no modo de exibição em um DataRepeater controle, opcionalmente, alinhá-lo com a parte superior do controle.

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

Sintaxe

'Declaração
Public Sub ScrollItemIntoView ( _
    index As Integer, _
    alignWithTop As Boolean _
)

public void ScrollItemIntoView(
    int index,
    bool alignWithTop
)

public:
void ScrollItemIntoView(
    int index, 
    bool alignWithTop
)

member ScrollItemIntoView : 
        index:int * 
        alignWithTop:bool -> unit

public function ScrollItemIntoView(
    index : int, 
    alignWithTop : boolean
)

Parâmetros

index
Tipo: System.Int32
O índice da DataRepeaterItem.

alignWithTop
Tipo: System.Boolean
true Para alinhar a parte superior da DataRepeaterItem com a parte superior do controle; Caso contrário, false.

Exceções

Exceção	Condição
ArgumentOutOfRangeException	O valor especificado para index é menor que 0 ou maior que ItemCount - 1.

Comentários

Chamar o ScrollItemIntoView método para exibir um determinado DataRepeaterItem na parte visível do controle.O item não será selecionado.Para selecionar o item, defina a CurrentItemIndex propriedade.

Para alinhar a parte superior do item com a parte superior do controle, defina a alignWithTop parâmetro para true.Se alignWithTop é false, o item será ser colocado na exibição por um algoritmo de rolagem mínimo; ele será não necessariamente alinhado com a parte superior do controle.

Exemplos

O exemplo de código a seguir demonstra como tornar o primeiro item exibido o item atualmente selecionado em um DataRepeater de controle e alinhá-lo com a parte superior do controle.Ele presume que você tenha um formulário que contém um DataRepeater controle denominado DataRepeater1 e um Button controle denominado SynchButton.

Private Sub SynchButton_Click() Handles SynchButton.Click
    ' If the first displayed item is not the current item.
    If DataRepeater1.FirstDisplayedItemIndex <> 
      DataRepeater1.CurrentItemIndex Then
        ' Make it the current item.
        DataRepeater1.CurrentItemIndex = 
          DataRepeater1.FirstDisplayedItemIndex
        ' Align it with the top of the control.
        DataRepeater1.ScrollItemIntoView( 
          DataRepeater1.FirstDisplayedItemIndex, True)
    End If
End Sub

private void synchButton_Click(System.Object sender, System.EventArgs e)
{
    // If the first displayed item is not the current item.
    if (dataRepeater1.FirstDisplayedItemIndex != dataRepeater1.CurrentItemIndex)
    // Make it the current item.
    {
        dataRepeater1.CurrentItemIndex = dataRepeater1.FirstDisplayedItemIndex;
        // Align it with the top of the control.
        dataRepeater1.ScrollItemIntoView(dataRepeater1.FirstDisplayedItemIndex, 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áveis.