CTreeCtrl::SetAutoscrollInfo

Definir taxa de autoscroll do controle atual do modo de exibição de árvore.

BOOL SetAutoscrollInfo(
     UINT uPixelsPerSec, 
     UINT uUpdateTime
);

Parâmetros

Parâmetro

Descrição

[in] uPixelsPerSec

O número de pixels por segundo de rolar.

[in] uUpdateTime

O intervalo de tempo entre atualizações do controle.

Valor de retorno

Sempre retorna true.

Comentários

Os parâmetros de autoscroll são usados para rolar no modo de exibição um item que não está visível no momento.O controle de exibição de árvore deve ter o estilo estendidas TVS_EX_AUTOHSCROLL , que é descrito em Estilos estendidos de controle de exibição de árvore.

este método envia a mensagem de TVM_SETAUTOSCROLLINFO , que é descrita em Windows SDK.

Requisitos

Cabeçalho: afxcmn.h

Este método é suportado no Windows XP e posteriormente.

Os requisitos adicionais para o método são descritos em Criar requisitos de controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir define uma variável, m_treeCtrl, que é usada para acessar o controle atual do modo de exibição de árvore.O exemplo de código também define um inteiro sem sinal e diversas variáveis de HTREEITEM.Essas variáveis são usados no exemplo a seguir.

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;

O exemplo de código a seguir define o comportamento de autoscroll do controle atual do modo de exibição de árvore.Em uma seção anterior do exemplo de código, que não é mostrado, nós criaremos um modo de exibição de árvore que consistisse em um país/nó raiz para o Estados Unidos, subnodes da região para os estados de Pensilvânia e de Washington, e itens da árvore para cidades nos estados.Nós fizemos intencionalmente o estreito de controle de exibição de árvore de modo que deve automaticamente rolar para exibir o item de árvore que tem o foco.O exemplo a seguir define o controle de exibição de árvore para rolar automaticamente por 30 segundo de pixels cada 5 segundos até que a está no modo.

    // Scroll 30 pixels/sec and redraw every 5 seconds.
    m_treeCtrl.SetAutoscrollInfo( 30, 5 ); 

Consulte também

Referência

Classe de CTreeCtrl

Gráfico de hierarquia

TVM_SETAUTOSCROLLINFO

Estilos estendidos de controle de exibição de árvore