Metodo DataRepeater.ScrollItemIntoView (Int32)

Articolo
05/16/2015

Scorre un oggetto DataRepeaterItem specificato nella visualizzazione in un controllo DataRepeater.

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

Sintassi

'Dichiarazione
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
)

Parametri

index
Tipo: Int32

Indice dell'oggetto DataRepeaterItem.

Eccezioni

Eccezione	Condizione
ArgumentOutOfRangeException	Il valore specificato per index è inferiore di 0 o maggiore di ItemCount - 1.

Note

Chiamare il ScrollItemIntoView metodo per visualizzare uno specifico DataRepeaterItem nella parte visibile del controllo. L'elemento non verrà selezionato. Per selezionare l'elemento, impostare il CurrentItemIndex proprietà.

L'elemento verrà scorso nella visualizzazione da un algoritmo di scorrimento minimo; esso non sarà necessariamente allineata alla parte superiore del controllo. Per allineare l'elemento con la parte superiore del controllo, chiamare l'overload ScrollItemIntoView metodo con il alignWithTop parametro impostato su true.

Esempi

Esempio di codice seguente viene illustrato come eseguire il primo elemento visualizzato l'elemento attualmente selezionato in un DataRepeater controllo. Si presuppone che si disponga di un modulo che contiene un DataRepeater controllo denominato DataRepeater1 e Button controllo denominato 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);
    }
}

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.