Compartilhar via


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

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

Confira também

Conceitual

ITextHost

OnTxPropertyBitsChange

Referência

Controles de edição avançada sem janelas