DocumentBase.FollowHyperlink Método

Definição

Namespace:

Microsoft.Office.Tools.Word

Assembly:

Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Resolverá um hiperlink ou exibirá um documento em cache se o documento já tiver sido baixado.

public void FollowHyperlink (ref object address, ref object subAddress, ref object newWindow, ref object addHistory, ref object extraInfo, ref object method, ref object headerInfo);

member this.FollowHyperlink : obj * obj * obj * obj * obj * obj * obj -> unit

Public Sub FollowHyperlink (Optional ByRef address As Object, Optional ByRef subAddress As Object, Optional ByRef newWindow As Object, Optional ByRef addHistory As Object, Optional ByRef extraInfo As Object, Optional ByRef method As Object, Optional ByRef headerInfo As Object)

Parâmetros

address

Object

O endereço do documento de destino.

subAddress

Object

O local dentro do documento de destino. O valor padrão é uma cadeia de caracteres vazia.

newWindow

Object

true para exibir o local de destino em uma nova janela. O valor padrão é false.

addHistory

Object

true para adicionar o link à pasta de histórico do dia atual.

extraInfo

Object

Uma matriz de cadeia de caracteres ou de bytes que especifica as informações adicionais para o HTTP usar para resolver o hiperlink. Por exemplo, você pode usar ExtraInfo para especificar as coordenadas de um mapa de imagem, o conteúdo de um formulário ou um nome de arquivo FAT. A cadeia de caracteres é postada ou acrescentada, dependendo do valor de Method. Use a propriedade ExtraInfoRequired para determinar se informações extras são necessárias.

method

Object

Especifica a maneira de tratar as informações adicionais para HTTP. MsoExtraInfoMethod.

headerInfo

Object

Uma cadeia de caracteres que especifica informações de cabeçalho para a solicitação HTTP. O valor padrão é uma cadeia de caracteres vazia. No Visual Basic, você pode combinar várias linhas de cabeçalho em uma única cadeia de caracteres usando a seguinte sintaxe: "string1 " & vbCr & "string2". A cadeia de caracteres especificada é convertida automaticamente em caracteres ANSI. Observe que o Headeargumento rInfo pode substituir campos de cabeçalho HTTP padrão.

Exemplos

O exemplo de código a seguir usa o FollowHyperlink método para exibir uma página da Web em uma nova janela. Para usar esse exemplo, execute-o na classe ThisDocument em um projeto no nível de documento.

private void DocumentFollowHyperlink()
{
    object address = "http://www.adatum.com/";
    object newWindow = true;
    object addHistory = false;

    this.FollowHyperlink(ref address, ref missing, ref newWindow,
        ref addHistory, ref missing, ref missing, ref missing);
}

Private Sub DocumentFollowHyperlink()
    Me.FollowHyperlink(Address:="http://www.adatum.com", _
        NewWindow:=True, AddHistory:=False)
End Sub

Comentários

Esse método exibe o documento armazenado em cache localizado no Address parâmetro , se ele já tiver sido baixado. Do contrário, esse método resolve o hiperlink, baixa o documento de destino e exibe o documento no aplicativo apropriado. Se o hiperlink usar o protocolo de arquivo, esse método abrirá o documento em vez de baixá-lo.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.