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

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

Sintaxis

HRESULT SetHwndPropServer(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

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 va a controlar el objeto de devolución de llamada especificado.

[in] cProps

Tipo: int

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

[in] pServer

Tipo: IAccPropServer*

Especifica el objeto de devolución de llamada, que se invocará cuando un cliente solicite una de las propiedades reemplazadas.

[in] annoScope

Tipo: AnnoScope

Puede ser ANNO_THIS, que indica que la anotación afecta únicamente al elemento accesible indicado; o bien, puede ser ANNO_CONTAINER, que indica que se aplica al elemento y a su elemento secundario inmediato.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Devuelve E_INVALIDARG si alguna de las propiedades de la matriz paProps no es compatible, si la cadena de identidad no es válida o si annoScope no es una de ANNO_THIS o ANNO_CONTAINER.

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

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 .

Requisitos

Consulte también

ClearHwndProps

IAccPropServices

SetHwndProp

SetHwndPropStr

SetPropServer