CTreeCtrl::SetAutoscrollInfo
Establece el índice del desplazamiento automático del control de vista de árbol actual.
BOOL SetAutoscrollInfo(
UINT uPixelsPerSec,
UINT uUpdateTime
);
Parámetros
Parámetro |
Descripción |
|---|---|
[in] uPixelsPerSec |
El número de píxeles por segundo que se va a mover. |
[in] uUpdateTime |
El intervalo de tiempo entre las actualizaciones del control. |
Valor devuelto
Siempre devuelve true.
Comentarios
Los parámetros de desplazamiento automático se utilizan para moverse por la vista un elemento que no está actualmente visible. El control de vista de árbol debe tener TVS_EX_AUTOHSCROLL extendió el estilo, que se describe en El control de vista de árbol extendidas los estilos.
Este método envía el mensaje TVM_SETAUTOSCROLLINFO , que se describe en Windows SDK.
Requisitos
Encabezado: afxcmn.h
Este método se admite en Windows XP y posterior.
Los requisitos adicionales para este método se describen en Requisitos de compilación para los controles comunes de Windows Vista.
Ejemplo
El ejemplo de código siguiente se define una variable, m_treeCtrl, que se utiliza para tener acceso al control de vista de árbol actual. El ejemplo de código también define un entero sin signo y varias variables de HTREEITEM. Estas variables se utilizan en el ejemplo siguiente.
public:
// Variable to access tree control.
CTreeCtrl m_treeCtrl;
// Variable to access splitbutton control.
CSplitButton m_splitbutton;
// Accessibility identifier
UINT accIdUS;
// HTREEITEMs
HTREEITEM hCountry;
HTREEITEM hPA;
HTREEITEM hWA;
El ejemplo de código siguiente establece el comportamiento de desplazamiento automático del control de vista de árbol actual. En una sección anterior del ejemplo de código, que no se muestra, creamos una vista de árbol que consta de un nodo de país o región raíz para Estados Unidos, los subnodos para los estados de Pennsylvania y Washington, y los elementos de árbol para las ciudades de esos estados. Creamos deliberadamente el reducido del control de vista de árbol de modo que debe desplazarse automáticamente para mostrar el elemento de árbol que tiene el foco. El ejemplo de código establece el control de vista de árbol automáticamente para desplazarse 30 píxeles por segundo cada 5 segundos hasta que el elemento de árbol está en la vista.
// Scroll 30 pixels/sec and redraw every 5 seconds.
m_treeCtrl.SetAutoscrollInfo( 30, 5 );