DataRepeater.ScrollItemIntoView (Método) (Int32)

Artículo
05/17/2015

Desplaza un objeto DataRepeaterItem especificado de forma que sea visible en un control DataRepeater.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
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
)

Parámetros

index
Tipo: Int32

Índice del objeto DataRepeaterItem.

Excepciones

Excepción	Condición
ArgumentOutOfRangeException	El valor especificado para index es menor de 0 o mayor de ItemCount - 1.

Comentarios

Llame a la ScrollItemIntoView método para mostrar una determinada DataRepeaterItem en la parte visible del control. No se seleccionará el elemento. Para seleccionar el elemento, establezca la CurrentItemIndex propiedad.

El elemento se puede desplazar en la vista mediante un algoritmo de desplazamiento mínimo; no necesariamente se alineará con la parte superior del control. Para alinear el elemento con la parte superior del control, llame a los métodos ScrollItemIntoView método con el alignWithTop establecido en true.

Ejemplos

En el ejemplo de código siguiente se muestra cómo hacer que el primer elemento que se muestra el elemento actualmente seleccionado en un DataRepeater control. Se supone que tiene un formulario que contenga un DataRepeater control denominado DataRepeater1 y un Button control denominado 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);
    }
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.