Freigeben über


DataRepeater.ScrollItemIntoView-Methode (Int32, Boolean)

Führt ein angegebenes DataRepeaterItem in Ansicht in ein DataRepeater-Steuerelement einen Bildlauf durch und legt optional mit der Spitze des Steuerelements aus.

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

Syntax

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

Parameter

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.

Um die oberste Position des Elements mit dem Rand des Steuerelements ausgerichtet, legen Sie den alignWithTop-Parameter in truefest.Wenn alignWithTopfalseist, wird das Element in der Ansicht einen Bildlauf durch einen minimalen Algorithmus Bildlauf durchgeführt. Es ist nicht unbedingt mit dem oberen Rand des Steuerelements ausgerichtet.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das erste angezeigte Element das aktuell ausgewählte Element in einem DataRepeater-Steuerelement macht und es mit oberen Rand des Steuerelements ausgerichtet werden.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

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)