DataRepeater.ScrollItemIntoView (Método) (Int32, Boolean)

Artículo
05/17/2015

Desplaza un objeto DataRepeaterItem especificado de forma que sea visible en un control DataRepeater, alineándolo opcionalmente con la parte superior del control.

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, _
    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
)

Parámetros

index
Tipo: Int32

Índice del objeto DataRepeaterItem.

alignWithTop
Tipo: Boolean

true para alinear la parte superior de DataRepeaterItem con la parte superior del control; en caso contrario, false.

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.

Para alinear la parte superior del elemento con la parte superior del control, establezca la alignWithTop parámetro true. Si alignWithTop es false, 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.

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 controlar y lo alinea con la parte superior del 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.