IDropTargetProvider::get_DropTargetEffect メソッド (uiautomationcore.h)

  • [アーティクル]

このドロップ ターゲットでグラブされた要素をユーザーが削除したときに発生する影響を記述するローカライズされた文字列を取得します。

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

構文

HRESULT get_DropTargetEffect(
  BSTR *pRetVal
);

パラメーター

pRetVal

戻り値

なし

解説

このプロパティは、ユーザーがターゲットでグラブされた要素を削除したときに発生する既定の効果 (要素の移動やコピーなど) について説明します。 このプロパティには、"move" などの短い文字列や、"Main グループへの挿入" などの長い文字列を指定できます。 文字列は常にローカライズされます。

このプロパティが変更された場合、プロバイダーは 、UIA_AutomationPropertyChangedEventId イベントを発生させてクライアントに通知する必要があります。

例

IFACEMETHODIMP CRegionProvider::get_DropTargetEffect(BSTR * pDefaultDropAction)
{
    WCHAR wszDropAction[100];
    LoadString(g_hInstance, IDS_REGION_DEFAULTDROPACTION1, wszDropAction, 
        ARRAYSIZE(wszDropAction));
    *pDefaultDropAction = ::SysAllocString(wszDropAction);
    return (*pDefaultDropAction == nullptr) ? E_OUTOFMEMORY : S_OK;
}

要件

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

こちらもご覧ください

IDropTargetProvider