Método IUIAutomationElement::GetCurrentPattern (uiautomationclient.h)

Recupera la interfaz IUnknown del patrón de control especificado en este elemento de automatización de la interfaz de usuario.

Sintaxis

HRESULT GetCurrentPattern(
  [in]          PATTERNID patternId,
  [out, retval] IUnknown  **patternObject
);

Parámetros

[in] patternId

Tipo: PATTERNID

Identificador del patrón de control. Para obtener una lista de identificadores de patrón de control, consulte Identificadores de patrón de control.

[out, retval] patternObject

Tipo: IUnknown**

Recibe un puntero a una interfaz IUnknown .

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método obtiene el patrón de control especificado en función de su disponibilidad en el momento de la llamada.

Para algunas formas de interfaz de usuario, este método incurrirá en sobrecarga de rendimiento entre procesos. Las aplicaciones pueden reducir la sobrecarga mediante el almacenamiento en caché de patrones de control y, a continuación, recuperarlos mediante IUIAutomationElement::GetCachedPattern.

Requisitos

   
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)

Consulte también

Conceptual

GetCachedPattern

GetCurrentPatternAs

IUIAutomationElement

Referencia

Información general acerca de los patrones de control de UI Automation