CTreeCtrl::SetAutoscrollInfo
Legt die Rate des automatischen Bildlaufs des aktuellen Strukturansicht-Steuerelements fest.
BOOL SetAutoscrollInfo(
UINT uPixelsPerSec,
UINT uUpdateTime
);
Parameter
Parameter |
Description |
|---|---|
[in] uPixelsPerSec |
Die Anzahl der Pixel pro Sekunde die zum liegen. |
[in] uUpdateTime |
Das Zeitintervall zwischen Updates des Steuerelements. |
Rückgabewert
Gibt immer true zurück.
Hinweise
Die Parameter des automatischen Bildlaufs werden verwendet, um in Ansicht ein Element liegen, das derzeit nicht sichtbar ist. Das Tree-Steuerelement muss das TVS_EX_AUTOHSCROLL erweiterte Format vorliegen, das in Strukturansicht-Steuerelement-erweiterte Formate beschrieben wird.
Diese Methode sendet die TVM_SETAUTOSCROLLINFO Meldung, die im Windows SDK beschrieben wird.
Anforderungen
Header: afxcmn.h
Diese Methode wird in Windows XP und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Anforderungen für die Erstellung von Windows Vista-Standardsteuerelementen beschrieben.
Beispiel
Im folgenden Codebeispiel wird eine Variable, m_treeCtrl, die verwendet wird, um auf das aktuelle Strukturansicht zuzugreifen. Im Codebeispiel wird auch eine ganze Zahl ohne Vorzeichen und einige HTREEITEM-Variablen. Diese Variablen werden im folgenden Beispiel verwendet.
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;
Im folgenden Codebeispiel wird das Verhalten des automatischen Bildlaufs des aktuellen Strukturansicht-Steuerelements fest. In einem früheren Abschnitt des Codebeispiels, das nicht angezeigt wird, haben wir eine Strukturansicht, die aus einem Stammland/regions-Knoten für USA, untergeordnete Knoten für die Pennsylvania und Staat Washington besteht, und Strukturelemente für Orte in diesen Zuständen. Wir haben absichtlich die Strukturansicht-Steuerelement-Enge, sodass sie automatisch einen Bildlauf durchführen muss, um das Strukturelement anzuzeigen, das den Fokus besitzt. Im Codebeispiel wird das Strukturansicht-Steuerelement fest, um 30 Pixel pro Sekunde alle 5 Sekunden automatisch einen Bildlauf durchzuführen, bis das Strukturelement in der Ansicht ist.
// Scroll 30 pixels/sec and redraw every 5 seconds.
m_treeCtrl.SetAutoscrollInfo( 30, 5 );