IRawElementProviderFragmentRoot

フラグメント内のルート要素上のメソッドとプロパティを公開します。

このインターフェイスは、フレームワーク内のルート要素(例えばウィンドウ内のリストボックス)によって実装されます。 同じフラグメント内の他の要素(リスト項目など)は、IRawElementProviderFragment インターフェイスを実装します。

このフラグメント内で指定した座標にある要素のプロバイダーを取得します。

Type: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

返されるプロバイダーは、指定した座標でマウス入力を受け取る要素に対応している必要があります。

座標がこの要素上にあるものの、いずれの子要素上にもない場合は、NULL またはフラグメントルートのプロバイダーが返されます。座標が、このフラグメントによってホストされている別のフレームワーク内の要素上にある場合、このメソッドは(IRawElementProviderFragment::GetEmbeddedFragmentRoots によって示されるとおり)そのフラグメントをホストする要素を返します。

例

次の例は、ハンドルが m_controlHwnd である HWND にホストされたリストボックスの実装を示しています。 IndexFromY はカーソル位置にあるリスト項目のインデックスを取得し、 GetItemByIndex はその項目の UI Automation プロバイダーを取得します。

HRESULT STDMETHODCALLTYPE ListProvider::ElementProviderFromPoint(double x, double y, IRawElementProviderFragment** pRetVal)
{
    if (pRetVal == NULL) 
    {
        return E_INVALIDARG;
    }
    POINT pt;
    pt.x = (LONG)x;
    pt.y = (LONG)y;
    ScreenToClient(m_controlHwnd, &pt);
    int itemIndex = this->m_pControl->IndexFromY(m_controlHwnd, pt.y);
    ListItemProvider* pItem = GetItemByIndex(itemIndex);  
    if (pItem != NULL)
    {
        *pRetVal = (IRawElementProviderFragment*)pItem;
        pItem->AddRef();
    }
    else 
    {
        pRetVal = (IRawElementProviderFragment*)this;
        pItem->AddRef();
    }

    return S_OK;
}            

このフラグメント内で入力フォーカスを持つ要素を取得します。

Type: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。