CTreeCtrl::SetAutoscrollInfo
現在のツリー ビュー コントロールの自動スクロール速度を設定します。
BOOL SetAutoscrollInfo(
UINT uPixelsPerSec,
UINT uUpdateTime
);
パラメーター
パラメーター |
説明 |
|---|---|
[入力] uPixelsPerSec |
スクロールするピクセルあたりの数。 |
[入力] uUpdateTime |
コントロールの更新の間の時間。 |
戻り値
常に true を返します。
解説
自動スクロールのパラメーターがビューに現在表示されない項目をスクロールするために使用されます。ツリー ビュー コントロールは ツリー ビュー コントロールの拡張スタイルで説明する TVS_EX_AUTOHSCROLL によって拡張スタイルが必要です。
このメソッドは Windows SDKで説明する TVM_SETAUTOSCROLLINFO のメッセージを送信します。
必要条件
ヘッダー: afxcmn.h
このメソッドは、Windows XP以降でサポートされます。
このメソッドに関するその他の要件については、「Windows Vista コモン コントロールの作成要件」を参照してください。
使用例
次のコード例は、現在のツリー ビュー コントロールへのアクセスに使用される変数、m_treeCtrlを定義します。コード例は、符号なし整数および複数のHTREEITEMの変数を定義します。これらの変数は次のように使用されます。
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;
次のコード例は、現在のツリー ビュー コントロールで自動スクロール動作を設定します。表示されていないコード例では、前のセクションでは、米国のルートの国または地域のノード、およびワシントン州ペンシルバニア状態のサブノードで構成される、これらの状態の都市のツリー項目のツリー ビューを作成しました。これは意図的にフォーカスがあるツリーの項目を表示するように自動的にスクロールしなければならないように、ツリー ビュー コントロールを狭くすることでした。コード例は、ツリー項目がビューに表示されるまでに30ピクセルをスクロールするためのツリー ビュー コントロールを自動的に5秒ごとに設定します。
// Scroll 30 pixels/sec and redraw every 5 seconds.
m_treeCtrl.SetAutoscrollInfo( 30, 5 );