Freigeben über


DataRepeater.ScrollItemIntoView-Methode (Int32)

Verschiebt eine angegebene DataRepeaterItem in den Anzeigebereich eines DataRepeater-Steuerelements.

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

Ausnahmen

Ausnahme Bedingung
ArgumentOutOfRangeException

Der angegebene Wert für index ist kleiner als 0 oder größer als ItemCount - 1.

Hinweise

Rufen Sie die ScrollItemIntoView -Methode zum Anzeigen eines bestimmtes DataRepeaterItem in den sichtbaren Bereich des Steuerelements. Das Element wird nicht ausgewählt werden. Um das Element auszuwählen, legen die CurrentItemIndex Eigenschaft.

Das Element wird von einem Algorithmus mit minimalen Bildlauf ein Bildlauf durchgeführt werden; Es wird nicht unbedingt am oberen Rand des Steuerelements ausgerichtet werden. Das Element am oberen Rand des Steuerelements ausgerichtet, die überladene ScrollItemIntoView Methode mit dem alignWithTop Parametersatz zu true.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie dem ersten angezeigten Element das aktuell ausgewählte Element in einem DataRepeater Steuerelement. Es wird davon ausgegangen, dass Sie ein Formular mit einer DataRepeater Steuerelement namens DataRepeater1 und ein Button -Steuerelement namens 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);
    }
}

.NET Framework-Sicherheit

Siehe auch

Referenz

DataRepeater Klasse

ScrollItemIntoView-Überladung

Microsoft.VisualBasic.PowerPacks-Namespace

CurrentItemIndex

FirstDisplayedItemIndex

Weitere Ressourcen

Einführung in das DataRepeater-Steuerelement (Visual Studio)

Gewusst wie: Suchen von Daten in einem DataRepeater-Steuerelement (Visual Studio)