Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Para usar a anotação direta para substituir o valor de uma propriedade
- Use a função CoCreateInstance ou a função CoCreateInstanceEx para criar o objeto IAccPropServices.
- Chame IAccPropServices::SetHwndProp, passando o HWND, ID do objeto, ID do filho, a propriedade a ser substituída e um VARIANT contendo o novo valor da propriedade. Esta etapa anota o valor.
- Solte os ponteiros da interface e libere a memória.
O exemplo a seguir mostra como anotar a propriedade Role de um controle de texto estático.
HRESULT CMyTextControl::SetAccessibleProperties()
{
// COM is assumed to be initialized...
IAccPropServices* pAccPropServices = NULL;
HRESULT hr = CoCreateInstance(CLSID_AccPropServices,
NULL, CLSCTX_SERVER, IID_IAccPropServices,
(void**)&pAccPropServices);
if (SUCCEEDED(hr))
{
// Annotating the Role of this object to be STATICTEXT
VARIANT var;
var.vt = VT_I4;
var.lVal = ROLE_SYSTEM_STATICTEXT;
hr = pAccPropServices->SetHwndProp(_hwnd,
OBJID_CLIENT,
CHILDID_SELF,
PROPID_ACC_ROLE,
var);
pAccPropServices->Release();
}
return hr;
}
Propriedades suportadas ao especificar um valor
As seguintes propriedades do Microsoft Ative Accessibility podem ser anotadas ao especificar um valor (onde o valor deve ser do tipo anotado) para anotação direta. Para substituir ou adicionar uma propriedade de Automação da Interface do Usuário da Microsoft a um controlo, pode-se especificar o identificador da propriedade de Automação da Interface do Usuário em vez do identificador da propriedade Microsoft Active Accessibility. Para obter uma lista de IDs de Automação de UI, consulte Identificadores de Propriedade.
| Propriedade | Tipo |
|---|---|
| PROPID_ACC_NAME | VT_BSTR |
| PROPID_ACC_DESCRIPTION | VT_BSTR |
| PROPID_ACC_ROLE | VT_I4 |
| PROPID_ACC_STATE | VT_I4 |
| PROPID_ACC_HELP | VT_BSTR |
| PROPID_ACC_KEYBOARDSHORTCUT | VT_BSTR |
| PROPID_ACC_DEFAULTACTION | VT_BSTR |
| PROPID_ACC_VALUEMAP | VT_BSTR |
| PROPID_ACC_ROLEMAP | VT_BSTR |
| PROPID_ACC_STATEMAP | VT_BSTR |