DataRepeater.ScrollItemIntoView, méthode (Int32, Boolean)

Article
05/16/2015

Fait défiler un DataRepeaterItem spécifié dans l'affichage dans un contrôle DataRepeater, en l'alignant éventuellement avec le haut du contrôle.

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

Paramètres

index
Type : Int32

Index de DataRepeaterItem.

alignWithTop
Type : Boolean

true pour aligner le bord supérieur de DataRepeaterItem avec le bord supérieur du contrôle ; sinon, false.

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

Pour aligner le haut de l'élément avec le haut du contrôle, définissez la alignWithTop paramètre true. Si alignWithTop est false, 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.

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 et l'aligner sur le haut du 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.