Metodo DataRepeater.ScrollItemIntoView (Int32, Boolean)

Articolo
05/16/2015

Scorre un oggetto DataRepeaterItem specificato nella visualizzazione di un controllo DataRepeater, allineandolo facoltativamente alla parte superiore del controllo.

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, _
    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
)

Parametri

index
Tipo: Int32

Indice dell'oggetto DataRepeaterItem.

alignWithTop
Tipo: Boolean

true per allineare la parte superiore dell'oggetto DataRepeaterItem alla parte superiore del controllo; in caso contrario, false.

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à.

Per allineare la parte superiore dell'elemento con la parte superiore del controllo, impostare il alignWithTop parametro true. Se alignWithTop è false, l'elemento verrà scorso nella visualizzazione da un algoritmo di scorrimento minimo; esso non sarà necessariamente allineata alla parte superiore del controllo.

Esempi

Esempio di codice seguente viene illustrato come eseguire il primo elemento visualizzato l'elemento attualmente selezionato in un DataRepeater controllare e Allinea alla parte superiore del 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.