Funciones miembro de control deslizante

Una aplicación puede llamar a las funciones miembro del control deslizante para recuperar información sobre el control deslizante (CSliderCtrl) y cambiar sus características.

Para recuperar la posición del control deslizante (es decir, el valor elegido por el usuario), use la función miembro GetPos. Para establecer la posición del control deslizante, use la función miembro SetPos. En cualquier momento, puede usar la VerifyPos función miembro para asegurarse de que el control deslizante está entre los valores mínimo y máximo.

El intervalo de un control deslizante es el conjunto de valores contiguos que el control deslizante puede representar. La mayoría de las aplicaciones usan la función miembro SetRange para establecer el intervalo de un control deslizante cuando se crea por primera vez. Las aplicaciones pueden modificar dinámicamente el intervalo una vez creado el control deslizante mediante las funciones miembro SetRangeMax y SetRangeMin. Una aplicación que permite cambiar el intervalo dinámicamente normalmente recupera la configuración final del intervalo cuando el usuario ha terminado de trabajar con el control deslizante. Para recuperar esta configuración, use las funciones miembro GetRange, GetRangeMax y GetRangeMin.

Una aplicación puede usar el estilo TBS_AUTOTICKS para que las marcas de graduación de un control deslizante se muestren automáticamente. Sin embargo, si una aplicación necesita controlar la posición o frecuencia de las marcas de graduación, se puede usar una serie de funciones miembro.

Para establecer la posición de una marca de graduación, una aplicación puede usar la función miembro SetTic. La función miembro SetTicFreq permite a una aplicación establecer marcas de graduación que aparecen a intervalos regulares en el intervalo del control deslizante. Por ejemplo, la aplicación puede usar esta función miembro para mostrar solo 10 marcas de graduación en un intervalo de 1 a 100.

Para recuperar el índice del intervalo correspondiente a una marca de graduación, use la función miembro GetTic. La función miembro GetTicArray recupera una matriz de estos índices. Para recuperar la posición de una marca de graduación, en coordenadas de cliente, use la función miembro GetTicPos. Una aplicación puede recuperar el número de marcas de graduación mediante la función miembro GetNumTics .

La función miembro ClearTics quita todas las marcas de graduación de un control deslizante.

El tamaño de línea de un control deslizante determina cuánto se mueve el control deslizante cuando una aplicación recibe un mensaje de notificación TB_LINEDOWN o TB_LINEUP. Del mismo modo, el tamaño de página determina la respuesta a los mensajes de notificación TB_PAGEDOWN y TB_PAGEUP. Las aplicaciones pueden recuperar y establecer los valores de tamaño de línea y página mediante las funciones miembro GetLineSize, SetLineSize, GetPageSize y SetPageSize.

Una aplicación puede usar funciones miembro para recuperar las dimensiones de un control deslizante. La función miembro GetThumbRect recupera el rectángulo delimitador del control deslizante. La función miembro GetChannelRect recupera el rectángulo delimitador del canal del control deslizante. (El canal es el área en la que se mueve el control deslizante y que contiene el elemento resaltado cuando se selecciona un intervalo).

Si un control deslizante tiene el estilo TBS_ENABLESELRANGE, el usuario puede seleccionar un intervalo de valores contiguos. Una serie de funciones miembro permiten ajustar el intervalo de selección dinámicamente. La función miembro SetSelection establece las posiciones inicial y final de una selección. Cuando el usuario haya terminado de establecer un intervalo de selección, una aplicación puede recuperar la configuración mediante la función miembro GetSelection. Para borrar la selección de un usuario, use la función miembro ClearSel.

Consulte también

Uso de CSliderCtrl
Controles