Sobre os controles SysLink
Um controle SysLink é uma janela que processa texto marcado e notifica o aplicativo quando os usuários clicam em seus hiperlinks incorporados. Este controlo fornece uma alternativa conveniente ao uso do botão de ligação de comando . Para obter mais informações, consulte Tipos de botão.
Cada controle SysLink pode suportar 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 Ativando estilos visuais.
Este artigo contém as seguintes seções.
Marcação SysLink
O controlo SysLink suporta a etiqueta âncora (<>) com os atributos HREF e ID. Um HREF pode ser qualquer protocolo, como http, ftp e mailto. Um ID é um nome opcional, único dentro de um controlo 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. Este índice é usado para acessar um link.
Atributos de ligações
Os atributos de cada link podem ser definidos dentro da tag â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 através do uso subsequente da mensagem LM_SETITEM.
Estados de ligação
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á ativado. |
| LIS_VISITED | O usuário já visitou a URL representada pelo link. |
Limitações na exibição de texto bidirecional
Algumas línguas, como o árabe ou o hebraico, são escritas da direita para a esquerda (RTL); O inglês é escrito da esquerda para a direita (LTR). A combinação de RTL com LTR é chamada de texto bidirecional. A mistura de 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 frase marcada com LTR pode não ser exibida corretamente no contexto RTL.
Observação
Os controles SysLink não suportam 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.