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. Steuerelementmuster ermöglichen es Clientanwendungen, das Steuerelement zu bearbeiten und Informationen darüber abzurufen.

Ein Anbieter implementiert ein Steuerelementmuster, indem er die folgenden Standard Schritte ausführt:

1. Implementieren Sie die Anbieterschnittstelle, die das Steuerelementmuster unterstützt. Um beispielsweise das Selection-Steuerelementmuster zu unterstützen, würde ein Anbieter für ein benutzerdefiniertes Listensteuerelement die ISelectionProvider-Schnittstelle implementieren.
2. Gibt ein Objekt zurück, das die Steuerelementmusteranbieterschnittstelle enthält, wenn Benutzeroberflächenautomatisierung die IRawElementProviderSimple::GetPatternProvider-Methode des Anbieters aufruft.

Das folgende Beispiel zeigt die ISelectionProvider-Schnittstellenimplementierung für ein benutzerdefiniertes Einzelauswahllistensteuerelement. Die Implementierung umfasst Eigenschaftenabrufmethoden 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 ISelectionProvider implementiert. Die meisten Listensteuerelemente würden auch andere Muster unterstützen, aber dieses Beispiel gibt einen NULL-Verweis für alle anderen Steuerelementmusterbezeichner zurück.

// 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;
}

Zugehörige Themen

Konzept

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung

How-To-Themen für Benutzeroberflächenautomatisierung Anbieter