DataRepeater.ScrollItemIntoView, méthode (Int32)

Article
05/16/2015

Fait défiler un DataRepeaterItem spécifié dans l'affichage dans un contrôle DataRepeater .

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
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
)

Paramètres

index
Type : Int32

Index de DataRepeaterItem.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	La valeur spécifiée pour index est inférieure à 0 ou supérieure àItemCount - 1.

Notes

Appelez le ScrollItemIntoView méthode pour afficher un spécifique DataRepeaterItem dans la partie visible du contrôle. L'élément ne sera pas sélectionné. Pour sélectionner l'élément, définissez la CurrentItemIndex propriété.

L'élément sera défiler dans l'affichage par un algorithme de défilement minimal ; Il n'est pas nécessairement être alignée avec le haut du contrôle. Pour aligner l'élément avec le haut du contrôle, appelez la surcharge ScrollItemIntoView méthode avec la alignWithTop paramètre défini sur true.

Exemples

L'exemple de code suivant montre comment créer le premier élément affiché l'élément actuellement sélectionné dans un DataRepeater contrôle. Il suppose que vous disposez d'un formulaire contenant une DataRepeater contrôle nommé DataRepeater1 et un Button contrôle nommé 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);
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.