TextRange Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Vertegenwoordigt een selectie van inhoud tussen twee TextPointer posities.
public ref class TextRange
public class TextRange
type TextRange = class
Public Class TextRange
- Overname
-
TextRange
- Afgeleid
Voorbeelden
In het volgende voorbeeld ziet u hoe u de Text eigenschap van een object TextRange gebruikt om de weergave van een opgegeven FlowDocumenttekst zonder opmaak te retourneren.
// This method returns a plain text representation of a specified FlowDocument.
string GetTextFromFlowDocument(FlowDocument flowDoc)
{
// Create a new TextRanage that takes the entire FlowDocument as the current selection.
TextRange flowDocSelection = new TextRange(flowDoc.ContentStart, flowDoc.ContentEnd);
// Use the Text property to extract a string that contains the unformatted text contents
// of the FlowDocument.
return flowDocSelection.Text;
}
' This method returns a plain text representation of a specified FlowDocument.
Private Function GetTextFromFlowDocument(ByVal flowDoc As FlowDocument) As String
' Create a new TextRanage that takes the entire FlowDocument as the current selection.
Dim flowDocSelection As New TextRange(flowDoc.ContentStart, flowDoc.ContentEnd)
' Use the Text property to extract a string that contains the unformatted text contents
' of the FlowDocument.
Return flowDocSelection.Text
End Function
Opmerkingen
De TextRange klasse introduceert de volgende terminologie.
Selectie : A TextRange is een selectie van inhoud tussen twee posities die worden aangegeven door TextPointers. Een van deze posities is een vast anker met betrekking tot de selectie, terwijl de andere positie beweegbaar is. Dit is vergelijkbaar met hoe een selectie van een gebruiker die de muis of het toetsenbord gebruikt, zich gedraagt.
Huidige selectie : omdat een TextRange selectie altijd in inhoud aangeeft, is het zinvol om gewoon naar de selectie te verwijzen die wordt aangegeven door een TextRange als de huidige selectie.
Text Container - Een tekstcontainer is het element dat de ultieme rand vormt voor de stroominhoud die bij de hand is; de selectie die wordt aangegeven door een TextRange tekstcontainer, valt altijd binnen een tekstcontainer. Op dit moment moet een tekstcontainer een FlowDocument of een TextBlock.
Document : de inhoud die gezamenlijk in een tekstcontainer is opgenomen, wordt een document genoemd.
Zie voor meer informatie over andere gerelateerde termen, zoals positie.TextPointer
Constructors
| Name | Description |
|---|---|
| TextRange(TextPointer, TextPointer) |
Initialiseert een nieuw exemplaar van de TextRange klasse, waarbij twee opgegeven posities worden gebruikt TextPointer als de begin- en eindposities voor het nieuwe bereik. |
Eigenschappen
| Name | Description |
|---|---|
| End |
De positie ophalen die het einde van de huidige selectie markeert. |
| IsEmpty |
Hiermee wordt een waarde opgehaald die aangeeft of de huidige selectie leeg is. |
| Start |
Hiermee haalt u de positie op waarmee het begin van de huidige selectie wordt gemarkeerd. |
| Text |
Hiermee haalt u de tekst zonder opmaak van de huidige selectie op of stelt u deze in. |
Methoden
| Name | Description |
|---|---|
| ApplyPropertyValue(DependencyProperty, Object) |
Hiermee past u een opgegeven opmaakeigenschap en -waarde toe op de huidige selectie. |
| CanLoad(String) |
Hiermee wordt gecontroleerd of de huidige selectie kan worden geladen met inhoud in een opgegeven gegevensindeling. |
| CanSave(String) |
Hiermee wordt gecontroleerd of de huidige selectie kan worden opgeslagen als een opgegeven gegevensindeling. |
| ClearAllProperties() |
Hiermee verwijdert u alle opmaakeigenschappen (vertegenwoordigd door Inline elementen) uit de huidige selectie. |
| Contains(TextPointer) |
Hiermee wordt gecontroleerd of een positie (opgegeven door een TextPointer) zich binnen de huidige selectie bevindt. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetPropertyValue(DependencyProperty) |
Retourneert de effectieve waarde van een opgegeven opmaakeigenschap voor de huidige selectie. |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| Load(Stream, String) |
Laadt de huidige selectie in een opgegeven gegevensindeling vanuit een opgegeven stroom. |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| Save(Stream, String, Boolean) |
Hiermee wordt de huidige selectie opgeslagen in een opgegeven stroom in een opgegeven gegevensindeling, met de optie om aangepaste TextElement objecten te behouden. |
| Save(Stream, String) |
Hiermee wordt de huidige selectie opgeslagen in een opgegeven stroom in een opgegeven gegevensindeling. |
| Select(TextPointer, TextPointer) |
Hiermee wordt de huidige selectie bijgewerkt, waarbij twee TextPointer posities worden gebruikt om de bijgewerkte selectie aan te geven. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
gebeurtenis
| Name | Description |
|---|---|
| Changed |
Treedt op wanneer het bereik wordt verplaatst om een nieuw inhoudsbereik te dekken. |