次の方法で共有


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

参照