IXRHitTestResults::GetItem (Windows Embedded CE 6.0)

1/6/2010

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] An 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 Silverlight 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. For more information, see Type-Safety in Silverlight for Windows Embedded.

.NET Framework Equivalent

None.

Requirements

See Also

Reference

IXRHitTestResults