IUIAutomationTextRange::ScrollIntoView メソッド (uiautomationclient.h)

テキスト範囲がビューポートに表示されるまで、テキストコントロールをスクロールさせます。

構文

HRESULT ScrollIntoView(
  [in] BOOL alignToTop
);

[in] alignToTop

種類: BOOL

テキスト 範囲がビューポートの上部と同じになるようにテキストコントロールをスクロールする必要がある場合は TRUE。 FALSE を 指定すると、ビューポートの下部にフラッシュされます。

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

メソッドは、非表示のテキストと表示されるテキストの両方を尊重します。テキスト範囲が非表示の場合、テキストコントロールは、非表示のテキストにビューポートにアンカーがある場合にのみスクロールします。

Microsoft UI オートメーションクライアントは、attr パラメーターを UIA_IsHiddenAttributeId に設定して IUIAutomationTextRange::GetAttributeValue を呼び出すことで、テキストの可視性をチェックできます。

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、WINDOWS XP SP3 と Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム、WINDOWS Server 2003 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)