Metodo DataRepeater.ScrollItemIntoView (Int32, Boolean)

Articolo
10/30/2012

scorre specificato DataRepeaterItem nella visualizzazione in un oggetto DataRepeater controllare, facoltativamente allineandola 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: System.Int32
L'indice di DataRepeaterItem.

alignWithTop
Tipo: System.Boolean
true per allineare la parte superiore di l DataRepeaterItem con la parte superiore del controllo; in caso contrario, false.

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

Per allineare la parte superiore dell'elemento con la parte superiore del controllo, impostare alignWithTop parametro di true.se alignWithTop viene false, l'elemento viene scorso nella visualizzazione da un algoritmo minimo di scorrimento; questi controlli non verrà allineato alla parte superiore del controllo.

Esempi

Nell'esempio di codice seguente viene illustrato come preparare il primo elemento visualizza l'elemento attualmente selezionato in un controllo DataRepeater archiviarlo e allineare alla parte superiore del controllo.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.