Metoda DataRepeater.ScrollItemIntoView — (Int32, Boolean)

Artykuł
05/17/2015

Przesuwa się z określonym DataRepeaterItem do widoku w DataRepeater kontroli, opcjonalnie dostosowanie jej górnej części kontrolki.

Przestrzeń nazw: Microsoft.VisualBasic.PowerPacks
Zestaw: Microsoft.VisualBasic.PowerPacks.Vs (w Microsoft.VisualBasic.PowerPacks.Vs.dll)

Składnia

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

Parametry

index
Typ: Int32

Indeks DataRepeaterItem.

alignWithTop
Typ: Boolean

trueAby wyrównać górnej krawędzi DataRepeaterItem z góry kontroli. w przeciwnym razie false.

Wyjątki

Wyjątek	Warunek
ArgumentOutOfRangeException	Wartość określona dla index jest mniejszy niż 0 lub większa niż ItemCount - 1.

Uwagi

Wywołanie ScrollItemIntoView metodę w celu wyświetlenia określonej DataRepeaterItem w widoczną część formantu.Element nie zostanie wybrany.Aby wybrać element, należy ustawić CurrentItemIndex właściwości.

Aby wyrównać górnej krawędzi elementu z góry formantu, należy ustawić alignWithTop parametr true.Jeśli alignWithTop jest false, element zostanie przewijane do widoku w minimalna algorytm przewijania; jego będzie nie musi być można wyrównane do górnej krawędzi formantu.

Przykłady

Poniższy przykładowy kod pokazuje, jak utworzyć pierwszego elementu wyświetlanego obecnie wybrany element w DataRepeater sterować i Wyrównaj ją do górnej krawędzi formantu.Przyjęto założenie, że formularz, który zawiera DataRepeater formantu o nazwie DataRepeater1 i Button formantu o nazwie 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);
    }
}

Zabezpieczenia programu .NET Framework

Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.