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 Requisitos de compilação para 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 );