ITextSelection.HomeKey(TextRangeUnit, Boolean) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Verschiebt die Einfügemarke oder das aktive Ende der Textauswahl an die Startposition, um die Funktionalität der Home-Taste nachzuahmen.
public:
int HomeKey(TextRangeUnit unit, bool extend);
int HomeKey(TextRangeUnit const& unit, bool const& extend);
public int HomeKey(TextRangeUnit unit, bool extend);
function homeKey(unit, extend)
Public Function HomeKey (unit As TextRangeUnit, extend As Boolean) As Integer
Parameter
- unit
- TextRangeUnit
Die Einheiten, um die Einfügemarke oder das aktive Ende zu verschieben. Die folgenden Werte sind gültig.
- extend
-
Boolean
bool
Gibt an, wie die Auswahl geändert werden soll. True erweitert die Auswahl, indem nur das aktive Ende verschoben wird. False reduziert die Auswahl auf eine Einfügemarke und verschiebt dann die Einfügemarke. Der Standardwert ist „FALSE“.
Gibt zurück
int
Die Anzahl der Einheiten, die die Einfügemarke oder das aktive Ende verschoben wird.
Hinweise
Die HomeKey-Methode ist eine logische Methode und keine direktionale Methode und daher von der betreffenden Sprache abhängig. Im arabischen Text wird beispielsweise HomeKey an das rechte Ende einer Zeile verschoben, während er sich im englischen Text nach links bewegt. Daher unterscheidet sich HomeKey von den Methoden ITextSelection.MoveRight oder ITextSelection.MoveLeft . HomeKey unterscheidet sich von der ITextRange.StartOf-Methode auch dadurch, dass sie vom aktiven Ende aus erweitert wird, während StartOf von der Startposition aus erweitert wird.