Método ITextHost::TxGetAcceleratorPos (textserv.h)

Artigo
03/05/2024

Solicita o caractere especial a ser usado para o caractere de acelerador de sublinhado.

Sintaxe

HRESULT TxGetAcceleratorPos(
  LONG *pcp
);

Parâmetros

pcp

Tipo: LONG*

A posição do caractere a ser sublinhado. Essa variável é definida pelo host de texto. Uma posição de caractere de –1 (ou seja, negativa) indica que nenhum caractere deve ser sublinhado.

Retornar valor

Tipo: HRESULT

O valor retornado é S_OK.

Comentários

Os aceleradores permitem atalhos de teclado ou teclas de acelerador para vários elementos da interface do usuário (como botões). Normalmente, o caractere de atalho é sublinhado.

Esse método informa ao objeto de serviços de texto qual caractere é o acelerador e, portanto, deve ser sublinhado. Observe que o objeto de serviços de texto não processa aceleradores; que é responsabilidade do host.

Normalmente, esse método só será chamado se o TXTBIT_SHOWACCELERATOR bit estiver definido no objeto de serviços de texto. Consulte OnTxPropertyBitsChange.

ObservaçãoQualquer alteração no texto no objeto de serviços de texto resulta na invalidação do sublinhado do acelerador. Nesse caso, é responsabilidade do host recalcular a posição de caractere apropriada e informar ao objeto de serviços de texto que um novo acelerador está disponível.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	textserv.h
DLL	Msftedit.dll