ITextRange.Link Eigenschaft

Definition

Namespace:

Windows.UI.Text

Ruft den URL-Text ab, der einem Textbereich zugeordnet ist, oder legt diese fest.

public:
 property Platform::String ^ Link { Platform::String ^ get(); void set(Platform::String ^ value); };

winrt::hstring Link();

void Link(winrt::hstring value);

public string Link { get; set; }

var string = iTextRange.link;
iTextRange.link = string;

Public Property Link As String

Eigenschaftswert

String

Platform::String

winrt::hstring

Die URL als Text.

Hinweise

Diese Methode legt den Anfang und das Ende des Textbereichs so fest, dass der gesamte Link eingeschlossen wird, einschließlich des Anzeigenamens, falls vorhanden.

Die URL-Zeichenfolge wird nicht überprüft. Der darin enthaltene Text muss in Anführungszeichen eingeschlossen werden, wobei optional das Sentinelzeichen 0xFDDF vorangestellt wird. Beispiel: "http://www.msn.com" oder 0xFDDF"http://www.msn.com".

Der Textbereich muss nicht degeneriert sein. Die folgenden Aktionen sind möglich:

• Wenn ein Teil des Anzeigenamens eines Links ausgewählt ist, wird der URL-Teil durch den Wert der Link-Eigenschaft ersetzt.
• Wenn ein Teil einer regulären URL ausgewählt ist, wird er zum Anzeigenamen des Links mit dem Wert der Link-Eigenschaft als URL.
• Wenn nicht verknüpfter Text ausgewählt ist: + Folgt der Text unmittelbar auf den Anzeigenamen eines Links und der Wert der Link-Eigenschaft mit der URL, wird der Text an den Anzeigenamen angefügt.
  • Andernfalls wird der Text zum Anzeigenamen eines Links mit dem Wert der Link-Eigenschaft als URL.

Der Textbereich kann an verschiedene Zeichenpositionen angepasst werden, nachdem diese Methode aufgerufen wurde.