Compartilhar via


Sobre controles SysLink

Um controle SysLink é uma janela que renderiza texto marcado e notifica o aplicativo quando os usuários clicam em seus hiperlinks incorporados. Esse controle fornece uma alternativa conveniente para usar o botão de link de comando. Para obter mais informações, consulte Tipos de botão.

Cada controle SysLink pode oferecer suporte a vários hiperlinks, e você pode acessar cada hiperlink por meio de um índice baseado em zero. O controle SysLink é definido no ComCtl32.dll versão 6 e requer um manifesto ou diretiva que especifica que a versão 6 da DLL deve ser usada se estiver disponível. Para obter mais informações, consulte Habilitando estilos visuais.

Este artigo inclui as seções a seguir.

O controle SysLink suporta a tag âncora(<a>) junto com os atributos HREF e ID. Um HREF pode ser qualquer protocolo, como http, ftp e mailto. Um ID é um nome opcional, exclusivo dentro de um controle SysLink e está associado a um link individual. Os links também recebem um índice baseado em zero de acordo com sua posição dentro da cadeia de caracteres. Esse índice é usado para acessar um link.

Os atributos de cada link podem ser definidos dentro da tag de âncora para cada link ou enviando a mensagem LM_SETITEM. Definir um atributo especificando-o dentro da cadeia de caracteres de inicialização apenas inicializa o valor. Você pode alterar o valor de um atributo por meio do uso subsequente da mensagem LM_SETITEM .

Os itens de link podem estar em qualquer um dos três estados, representados pelos sinalizadores na tabela a seguir.

Bandeira do estado Aparência e significado
LIS_FOCUSED O link tem o foco do teclado e pressionar Enter o ativa.
LIS_ENABLED O link está habilitado.
LIS_VISITED O usuário já visitou a URL representada pelo link.

 

Limitações na exibição de texto bidirecional

Alguns idiomas, como árabe ou hebraico, são escritos da direita para a esquerda (RTL); Inglês é escrito da esquerda para a direita (LTR). A combinação de RTL com LTR é chamada de texto bidirecional. Misturar construções de marcação direcional LTR e RTL Unicode ou HTML em cadeias de caracteres de recursos, como marcadores de fluxo bidirecionais para controlar o fluxo de cadeias de caracteres, pode não produzir o resultado esperado ao usar um controle SysLink. Por exemplo, uma sentença marcada com LTR pode não ser exibida corretamente no contexto RTL.

Observação

Os controles SysLink não oferecem suporte à exibição bidirecional em todos os cenários. Use um controle SysLink somente se você souber que um layout LTR ou RTL simples é adequado. Caso contrário, considere usar uma tecnologia mais avançada, como MSHTML.