event.h

Clase wxScrollEvent

Un evento de desplazamiento contiene información sobre eventos enviados desde barras de desplazamiento independientes (ver wxScrollBar) y deslizadores (ver wxSlider).

Jerarquía:

Jerarquía de la clase wxScrollEvent

Hay que tener en cuenta que las ventanas desplazadas envían el evento wxScrollWinEvent que no deriva de wxCommandEvent, sino directamente de wxEvent - no se debe confundir estos dos tipos de eventos y utilizar las macros de la tabla de eventos que se mencionan a continuación sólo para los controles tipo barra de desplazamiento.

Diferencia entre EVT_SCROLL_THUMBRELEASE y EVT_SCROLL_CHANGED

El evento EVT_SCROLL_THUMBRELEASE sólo se emite cuando realmente se arrastra el pulgar usando el ratón y se suelta (Este evento EVT_SCROLL_THUMBRELEASE también es seguido por un evento EVT_SCROLL_CHANGED).

El evento EVT_SCROLL_CHANGED también ocurre cuando se usa el teclado para cambiar la posición del pulgar, y cuando se hace click al lado del pulgar (En todos estos casos el evento EVT_SCROLL_THUMBRELEASE no ocurre).

En resumen, el evento EVT_SCROLL_CHANGED se dispara cuando el desplazamiento/movimiento ha finalizado independientemente de la forma en que se había iniciado. Por favor, ver el ejemplo de Widgets (página "Slider") para ver la diferencia entre EVT_SCROLL_THUMBRELEASE y EVT_SCROLL_CHANGED en acción.

Observaciones

Hay que tener en cuenta que a menos que se especifique un identificador de control de desplazamiento, se tendrá que comprobar la orientación de la barra de desplazamiento con wxScrollEvent::GetOrientation, ya que los eventos de desplazamiento horizontal y vertical se procesan utilizando el mismo manejador de eventos.

Eventos que usan esta clase

Las siguientes macros manejadoras de eventos redirigen los eventos a manejadores de funciones miembro 'func' con prototipos como:

void handlerFuncName(wxScrollEvent& event)

Macros de eventos:

Se pueden usar macros EVT_COMMAND_SCROLL... con IDs de ventana para cuando se intercepten eventos de desplazamiento desde controles, o macros EVT_SCROLL... sin IDs de ventana para interceptar eventos de desplazamiento desde la ventana receptora - excepto por esto, las macros se comportan exactamente igual.

EVT_SCROLL(func)
Procesa todos los eventos de desplazamiento.
EVT_SCROLL_TOP(func)
Procesa los eventos wxEVT_SCROLL_TOP de desplazamiento hacia arriba o hacia la izquierda (mínimo).
EVT_SCROLL_BOTTOM(func)
Procesa los eventos wxEVT_SCROLL_BOTTOM de desplazamiento hacia abajo o hacia la derecha (posición máxima).
EVT_SCROLL_LINEUP(func)
Procesa los eventos wxEVT_SCROLL_LINEUP de desplazamiento hacia arriba o hacia la izquierda.
EVT_SCROLL_LINEUP(func)
Procesa los eventos wxEVT_SCROLL_LINEDOWN línea abajo o derecha.
EVT_SCROLL_PAGEUP(func)
Procesa los eventos wxEVT_SCROLL_PAGEUP página arriba o izquierda.
EVT_SCROLL_PAGEDOWN(func)
Procesa eventos wxEVT_SCROLL_PAGEDOWN de página abajo o derecha.
EVT_SCROLL_THUMBTRACK(func)
Procesa eventos wxEVT_SCROLL_THUMBTRACK thumbtrack (eventos frecuentes enviados cuando el usuario arrastra el thumbtrack).
EVT_SCROLL_THUMBRELEASE(func)
Procesa los eventos wxEVT_SCROLL_THUMBRELEASE de liberación del pulgar.
EVT_SCROLL_CHANGED(func)
Procesa los eventos wxEVT_SCROLL_CHANGED de fin de desplazamiento (sólo MSW).
EVT_COMMAND_SCROLL(id, func)
Procesa todos los eventos de desplazamiento.
EVT_COMMAND_SCROLL_TOP(id, func)
Procesa los eventos wxEVT_SCROLL_TOP de desplazamiento hacia arriba o hacia la izquierda (mínimo).
EVT_COMMAND_SCROLL_BOTTOM(id, func)
Procesa los eventos wxEVT_SCROLL_BOTTOM de desplazamiento hacia abajo o hacia la derecha (posición máxima).
EVT_COMMAND_SCROLL_LINEUP(id, func)
Procesa los eventos wxEVT_SCROLL_LINEUP de desplazamiento hacia arriba o hacia la izquierda.
EVT_COMMAND_SCROLL_LINEDOWN(id, func)
Procesa los eventos wxEVT_SCROLL_LINEDOWN línea abajo o derecha.
EVT_COMMAND_SCROLL_PAGEUP(id, func)
Procesa los eventos wxEVT_SCROLL_PAGEUP página arriba o izquierda.
EVT_COMMAND_SCROLL_PAGEDOWN(id, func)
Procesa los eventos wxEVT_SCROLL_PAGEDOWN page down o right.
EVT_COMMAND_SCROLL_THUMBTRACK(id, func)
Procesa eventos wxEVT_SCROLL_THUMBTRACK thumbtrack (eventos frecuentes enviados cuando el usuario arrastra el thumbtrack).
EVT_COMMAND_SCROLL_THUMBRELEASE(func)
Procesa los eventos wxEVT_SCROLL_THUMBRELEASE de liberación del pulgar.
EVT_COMMAND_SCROLL_CHANGED(func)
Procesa los eventos wxEVT_SCROLL_CHANGED de fin de desplazamiento (sólo MSW).

Funciones miembro

wxScrollEvent()

wxScrollEvent::wxScrollEvent( wxEventType commandType = wxEVT_NULL, int id = 0, int pos = 0, int orientation = 0 )

Constructor.

GetOrientation()

int wxScrollEvent::GetOrientation() const

Devuelve wxHORIZONTAL o wxVERTICAL, dependiendo de la orientación de la barra de desplazamiento.

GetPosition()

int wxScrollEvent::GetPosition() const

Devuelve la posición de la barra de desplazamiento.

SetOrientation()

void wxScrollEvent::SetOrientation(int orient)

SetPosition()

void wxScrollEvent::SetPosition(int pos)

Métodos y datos heredados

Esta clase hereda los métodos y datos miembro públicos y protegidos de wxCommandEvent, wxEvent y wxObject.