Share via


IXRHitTestResults::GetItem (Compact 2013)

3/28/2014

This method retrieves the item at the specified index in this hit-test results object.

Syntax

virtual HRESULT STDMETHODCALLTYPE GetItem(
    int ItemIndex,
    IXRDependencyObject** ppItem
) = 0;

Parameters

  • ItemIndex
    [in] Integer value that specifies the index location of the affected object for which you want to retrieve an object pointer.
  • ppItem
    [out] Address of a pointer to an IXRDependencyObject at the specified indexed location. It represents a UI element that was affected by the hit test.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

A hit-test results object contains an ordered list of objects that were affected by a hit test.

You can calculate the number of indexed items in the list by retrieving the item count from the method IXRHitTestResults::GetCount.

To use a specific interface pointer type, you can use the helper template version of this method that XAML for Windows Embedded provides. When you supply a derived type, this version automatically supplies a type-safe method that implicitly converts the returned type from a generic interface so you do not have to explicitly call QueryInterface to convert the generic interface into the required object type.

.NET Framework Equivalent

None.

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

IXRHitTestResults
IXRUIElement::HitTest