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
- 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.
Siehe auch
Referenz
Microsoft.VisualBasic.PowerPacks-Namespace
Weitere Ressourcen
Einführung in das DataRepeater-Steuerelement (Visual Studio)
Gewusst wie: Suchen von Daten in einem DataRepeater-Steuerelement (Visual Studio)