Método IAccPropServices::ClearHwndProps (oleacc.h)

Este método encapsula SetPropValue, SetPropServer y ClearProps, y proporciona un punto de entrada conveniente para los autores de llamadas que anotan elementos accesibles basados en HWND.

Sintaxis

HRESULT ClearHwndProps(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Parámetros

[in] hwnd

Tipo: HWND

Identifica el elemento accesible que se va a anotar. Esto reemplaza a la cadena de identidad.

[in] idObject

Tipo: DWORD

Identifica el elemento accesible que se va a anotar. Esto reemplaza a la cadena de identidad.

[in] idChild

Tipo: DWORD

Identifica el elemento accesible que se va a anotar. Esto reemplaza a la cadena de identidad.

[in] paProps

Tipo: const MSAAPROPID*

Especifica una matriz de propiedades que se van a restablecer. Estas propiedades se revertirán al comportamiento predeterminado que presentaban antes de anotarlas.

[in] cProps

Tipo: int

Especifica el número de propiedades de la matriz paProps.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK, incluso si las propiedades especificadas nunca se anotaron en el objeto accesible; Borrar propiedades ya borradas se considera un éxito.

Devuelve E_INVALIDARG si no se admite ninguna de las propiedades de la matriz paProps .

Puede devolver otros códigos de error en condiciones de error excepcionales, como memoria baja.

Para obtener descripciones de los valores devueltos, vea el método SetPropValue, SetPropServer o ClearProps correspondiente.

Comentarios

Mediante este método, el autor de la llamada no tiene que obtener una cadena de identidad; puede especificar directamente los parámetros hwnd, idObject e idChild .

Además, SetHwndPropStr toma una cadena Unicode normal como parámetro; el autor de la llamada no necesita asignar especialmente un BSTR.

Requisitos

Consulte también

ClearProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetHwndPropStr