IUIAutomationElement3::get_CurrentIsPeripheral メソッド (uiautomationclient.h)

要素の現在の周辺機器 UI インジケーターを取得します。

このプロパティは読み取り専用です。

構文

HRESULT get_CurrentIsPeripheral(
  BOOL *retVal
);

パラメーター

retVal

戻り値

なし

解説

IsPeripheral プロパティが TRUE の場合、クライアント アプリケーションは、現在キーボード対話型であっても、 要素によってフォーカスが取得されたと見なすことはできません。

このプロパティは、次のコントロールの種類に関連します。

• UIA_GroupControlTypeId
• UIA_MenuControlTypeId
• UIA_PaneControlTypeId
• UIA_ToolBarControlTypeId
• UIA_ToolTipControlTypeId
• UIA_WindowControlTypeId
• UIA_CustomControlTypeId

周辺機器 UI が関連するパターンの 1 つをサポートしている場合、多くの場合、周辺機器 UI の外観によってこれらのイベントのいずれかがトリガーされます。

• WindowOpened (UIA_Window_WindowOpenedEventId)
• MenuOpened (UIA_MenuOpenedEventId)
• ToolTipOpened (UIA_ToolTipOpenedEventId)

支援テクノロジであるクライアント アプリケーションがこれらのイベントのいずれかを処理する場合、クライアントは CurrentIsPeripheral の値をチェックする必要があります。 値が TRUE の場合、クライアントは、変更されたフォーカスを新しい UI または目的の UI のインジケーターとして使用できないため、ユーザーが 1 つのアクションで到達できる周辺機器 UI の代替表現を提供する必要がある場合があります。 それ以外の場合、周辺機器 UI はコントロール ビューやタブ シーケンスなどに存在しません。 クライアントでは、一度に 1 つの周辺機器 UI 項目のみがツリー全体に存在することが保証され、別の UI 項目を開くと、最初の UI 項目が自動的に閉じられます。

要件

サポートされている最小のクライアント	Windows 8.1 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)

関連項目

IUIAutomationElement3

参照