DataRepeater.ScrollItemIntoView, méthode (Int32)

Article
11/15/2012

Fait défiler DataRepeaterItem spécifié dans la vue dans un contrôle d'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 : System.Int32
Index de DataRepeaterItem.

Exceptions

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

Notes

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

L'élément sera fait défiler dans la vue par un algorithme minimum de défilement ; il ne sera pas nécessairement aligné avec le haut du contrôle.Pour aligner l'élément avec le haut du contrôle, appelez la méthode surchargée d'ScrollItemIntoView avec le jeu de paramètres d'alignWithTop à true.

Exemples

L'exemple de code suivant montre comment faire au premier élément affiché actuellement l'élément sélectionné dans un contrôle d'DataRepeater.Il suppose que vous avez un formulaire qui contient un contrôle d'DataRepeater nommé DataRepeater1 et un contrôle d'Button 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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.