Unterstützung von Steuerelementmustern in einem Benutzeroberflächenautomatisierungs-Anbieter
In diesem Thema wird gezeigt, wie ein Microsoft Benutzeroberflächenautomatisierung-Anbieter Steuerelementmuster für ein Steuerelement implementiert. Mit Steuerelementmustern können Clientanwendungen das Steuerelement bearbeiten und Informationen dazu abrufen.
Ein Anbieter implementiert ein Steuerelementmuster, indem er die folgenden Hauptschritte durchführt:
- Implementieren Sie die Anbieterschnittstelle, die das Steuerelementmuster unterstützt. Um beispielsweise das Selection-Steuerelementmuster zu unterstützen, implementiert ein Anbieter für ein benutzerdefiniertes Listensteuerelement die ISelectionProvider-Schnittstelle.
- Gibt ein Objekt zurück, das die Schnittstelle des Steuerelementmusteranbieters enthält, wenn Benutzeroberflächenautomatisierung die IRawElementProviderSimple::GetPatternProvider-Methode des Anbieters aufruft.
Das folgende Beispiel zeigt die ISelectionProvider-Schnittstellenimplementierung für ein benutzerdefiniertes Einzelauswahllisten-Steuerelement. Die Implementierung umfasst Methoden zum Abrufen von Eigenschaften für die Eigenschaften IsSelectionRequired und CanSelectMultiple sowie eine Methode zum Abrufen des Anbieters für das ausgewählte Listenelement.
// Specifies whether the list control supports the selection of
// multiple items at the same time.
IFACEMETHODIMP ListProvider::get_CanSelectMultiple(BOOL *pRetVal)
{
*pRetVal = FALSE;
return S_OK;
}
// Specifies whether the list must have an item selected at all times.
IFACEMETHODIMP ListProvider::get_IsSelectionRequired(BOOL *pRetVal)
{
*pRetVal = TRUE;
return S_OK;
}
// Retrieves the provider of the selected item in a custom list control.
//
// m_pControl - pointer to an application-defined object for managing
// the custom list control.
//
// ListItemProvider - application-defined class that inherits the
// IRawElementProviderSimple interface.
//
// GetItemProviderByIndex - application-defined method that retrieves the
// IRawElementProviderSimple interface of the selected item.
IFACEMETHODIMP ListProvider::GetSelection(SAFEARRAY** pRetVal)
{
// Create a safe array to store the IRawElementProviderSimple pointer.
SAFEARRAY *psa = SafeArrayCreateVector(VT_UNKNOWN, 0, 1);
// Retrieve the index of the selected list item.
int index = m_pControl->GetSelectedIndex();
// Retrieve the IRawElementProviderSimple pointer of the selected list
// item. ListItemProvider is an application-defined class that
// inherits the IRawElementProviderSimple interface.
ListItemProvider* pItem = GetItemProviderByIndex(index);
if (pItem != NULL)
{
LONG i = 0;
SafeArrayPutElement(psa, &i, pItem);
}
*pRetVal = psa;
return S_OK;
}
Das folgende Beispiel zeigt eine Implementierung von IRawElementProviderSimple::GetPatternProvider, die ein Objekt zurückgibt, das ISelectionProviderimplementiert. Die meisten Listensteuerelemente unterstützen auch andere Muster, aber in diesem Beispiel wird ein NULL-Verweis für alle anderen Steuerelementmusterbezeichner zurückgegeben.
// Retrieves an object that supports the control pattern provider interface
// for the specified control pattern.
IFACEMETHODIMP ListProvider::GetPatternProvider(PATTERNID patternId, IUnknown** pRetVal)
{
*pRetVal = NULL;
if (patternId == UIA_SelectionPatternId)
{
// Return the object that implements ISelectionProvider. In this example,
// ISelectionProvider is implemented in the current object (this).
*pRetVal = static_cast<IRawElementProviderSimple*>(this);
AddRef();
}
return S_OK;
}