DataRepeater.ScrollItemIntoView-Methode (Int32, Boolean)

Artikel
05/16/2015

Verschiebt ein angegebenes DataRepeaterItem in den Anzeigebereich eines DataRepeater-Steuerelements und richtet es optional am oberen Rand 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: Int32

Der Index des DataRepeaterItem.

alignWithTop
Typ: Boolean

true, damit der Rand der DataRepeaterItem am Rand des Steuerelements ausgerichtet wird; andernfalls false.

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.

Um den oberen Rand des Elements am oberen Rand des Steuerelements auszurichten, legen die alignWithTop Parameter true. Wenn alignWithTop ist false, das Element wird Bildlauf angezeigt werden von einem minimalen Bildlauf Algorithmus; Es wird nicht unbedingt am oberen Rand des Steuerelements ausgerichtet werden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie dem ersten angezeigten Element das aktuell ausgewählte Element in einem DataRepeater steuern, und richten Sie es mit dem oberen Rand des Steuerelements. 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.