DataRepeater.ScrollItemIntoView-Methode (Int32, Boolean)

Artikel
10/24/2012

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

index
Typ: System.Int32
Der Index des DataRepeaterItem.

alignWithTop
Typ: System.Boolean
true zum oberen Rand DataRepeaterItem mit dem oberen Rand des Steuerelements ausgerichtet. andernfalls false.

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

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.