DataRepeater.ScrollItemIntoView-Methode (Int32)

Artikel
05/16/2015

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

index
Typ: Int32

Der Index des DataRepeaterItem.

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

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.