DataRepeater.ScrollItemIntoView-Methode (Int32)

Artikel
10/24/2012

Führt ein angegebenes DataRepeaterItem in Ansicht in ein DataRepeater-Steuerelement den Bildlauf durch.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
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
)

Parameter

index
Typ: System.Int32
Der Index des DataRepeaterItem.

Ausnahmen

Ausnahme	Bedingung
ArgumentOutOfRangeException	Der Wert, der für index angegeben wird, ist kleiner als 0 oder größer als ItemCount - 1.

Hinweise

Rufen Sie die ScrollItemIntoView-Methode auf, um ein bestimmtes DataRepeaterItem im sichtbaren Bereich des Steuerelements angezeigt.Das Element ist nicht aktiviert.Um das Element auszuwählen, legen Sie die CurrentItemIndex-Eigenschaft fest.

Das Element wird durch einen minimalen Bildlauf in der Ansicht einen Bildlauf Algorithmus ausgeführt. Es ist nicht unbedingt mit dem oberen Rand des Steuerelements ausgerichtet.Um das Element mit dem Rand des Steuerelements ausgerichtet werden kann, rufen Sie die überladene ScrollItemIntoView-Methode mit dem alignWithTop-Parameter an, der zu truefestgelegt ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das erste angezeigte Element das aktuell ausgewählte Element in einem DataRepeater-Steuerelement macht.Es wird davon ausgegangen, dass Sie über ein Formular verfügen, das ein DataRepeater-Steuerelement mit dem Namen DataRepeater1 und ein Button-Steuerelement, das SynchButtonbenannt ist.

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);
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.