CTreeCtrl::SetAutoscrollInfo
Définit le taux de défilement automatique du contrôle arborescence actuel.
BOOL SetAutoscrollInfo(
UINT uPixelsPerSec,
UINT uUpdateTime
);
Paramètres
Paramètre |
Description |
|---|---|
[in] uPixelsPerSec |
Le nombre de pixels par seconde au défilement. |
[in] uUpdateTime |
L'intervalle entre les mises à jour du contrôle. |
Valeur de retour
Retourne toujours true.
Notes
Les paramètres de défilement automatique sont utilisés pour faire défiler dans l'affichage un élément qui n'est pas actuellement visible. Le contrôle arborescence doit avoir le style étendu par TVS_EX_AUTOHSCROLL , qui est décrit dans styles étendus de contrôle arborescence.
Cette méthode envoie le message de TVM_SETAUTOSCROLLINFO , qui est décrit dans Kit de développement logiciel Windows.
Configuration requise
en-tête : afxcmn.h
Cette méthode est prise en charge dans Windows XP et versions ultérieures.
Les spécifications supplémentaires pour cette méthode sont décrites dans Spécifications pour la génération des contrôles communs Windows Vista.
Exemple
l'exemple de code suivant définit une variable, m_treeCtrl, qui est utilisée pour accéder au contrôle arborescence actuel. l'exemple de code définit également un entier non signé et plusieurs variables de HTREEITEM. Ces variables sont utilisées dans l'exemple suivant.
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;
L'exemple de code suivant définit le comportement de défilement automatique du contrôle arborescence actuel. Dans la première section de l'exemple de code, qui n'est pas indiqué, nous avons créé une arborescence qui se compose d'un nœud de pays/région racine pour les états-unis, sous-nœuds pour les états de la Pennsylvanie et de Washington, et les éléments d'arborescence pour les villes dans les rapports. Nous avons intentionnellement fait l'étroite de contrôle arborescence afin qu'il ait automatiquement le défilement pour afficher l'élément d'arborescence qui a le focus. L'exemple de code définit le contrôle arborescence pour faire défiler automatiquement 30 pixels par seconde toutes les 5 secondes jusqu'à ce que l'élément d'arborescence est en mode.
// Scroll 30 pixels/sec and redraw every 5 seconds.
m_treeCtrl.SetAutoscrollInfo( 30, 5 );