Método DataRepeater.ScrollItemIntoView (Int32)

Artigo
05/17/2015

Rola especificada DataRepeaterItem no modo de exibição em uma DataRepeater 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 _
)

public void ScrollItemIntoView(
    int index
)

public:
void ScrollItemIntoView(
    int index
)

member ScrollItemIntoView : 
        index:int -> unit

public function ScrollItemIntoView(
    index : int
)

Parâmetros

index
Tipo: Int32

O índice da DataRepeaterItem.

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 o CurrentItemIndex propriedade.

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. Para alinhar o item com a parte superior do controle, chamar a sobrecarga ScrollItemIntoView método com o alignWithTop parâmetro definido como true.

Exemplos

O exemplo de código a seguir demonstra como fazer o primeiro item exibido o item atualmente selecionado em um DataRepeater controle. Ele presume que você tenha um formulário que contém um DataRepeater controle chamado DataRepeater1 e um Button controle chamado 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ável.