Metodo DataRepeater.ScrollItemIntoView (Int32)

Articolo
10/30/2012

scorre specificato DataRepeaterItem nella visualizzazione in un oggetto DataRepeater controllare.

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: System.Int32
L'indice di DataRepeaterItem.

Eccezioni

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

Note

chiamare ScrollItemIntoView metodo per visualizzare uno specifico DataRepeaterItem nella parte visibile del controllo.l'elemento non sarà selezionato.per selezionare l'elemento, impostare CurrentItemIndex proprietà.

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

Esempi

Nell'esempio di codice seguente viene illustrato come preparare il primo elemento visualizza l'elemento attualmente selezionato in un controllo DataRepeater controllare.Si presuppone che si disponga di un form contenente un controllo 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 ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.