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

Article
11/15/2012

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

alignWithTop
Type : System.Boolean
true pour aligner le haut d'DataRepeaterItem avec le haut du contrôle ; sinon, false.

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.

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

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