TextPointer.GetLineStartPosition Метод

Определение

Возвращение TextPointer в начало строки, задаваемое относительно текущего TextPointer.Returns a TextPointer to the beginning of a line that is specified relative to the current TextPointer.

Перегрузки

GetLineStartPosition(Int32)

Возвращение TextPointer в начало строки, задаваемое относительно текущего TextPointer.Returns a TextPointer to the beginning of a line that is specified relative to the current TextPointer.

GetLineStartPosition(Int32, Int32)

Возвращение TextPointer в начало строки, задаваемое относительно текущего TextPointer, и создание отчета о числе пропущенных строк.Returns a TextPointer to the beginning of a line that is specified relative to the current TextPointer, and reports how many lines were skipped.

GetLineStartPosition(Int32)

Возвращение TextPointer в начало строки, задаваемое относительно текущего TextPointer.Returns a TextPointer to the beginning of a line that is specified relative to the current TextPointer.

public:
 System::Windows::Documents::TextPointer ^ GetLineStartPosition(int count);
public System.Windows.Documents.TextPointer GetLineStartPosition (int count);
member this.GetLineStartPosition : int -> System.Windows.Documents.TextPointer
Public Function GetLineStartPosition (count As Integer) As TextPointer

Параметры

count
Int32

Число маркеров начала строки, которые надо пропустить при определении строки, для которой требуется вернуть начальное положение.The number of start-of-line markers to skip when determining the line for which to return the starting position. Отрицательные значения указывают предшествующие строки, 0 задает текущую строку, а положительные значения задают следующие строки.Negative values specify preceding lines, 0 specifies the current line, and positive values specify following lines.

Возвраты

TextPointer, указывающий на начало указанной строки (при том, что для LogicalDirection задано значение Forward), или null, если указанная строка выходит за пределы диапазона или не может быть обнаружена иным способом.A TextPointer pointing to the beginning of the specified line (with the LogicalDirection set to Forward), or null if the specified line is out of range or otherwise cannot be located.

Комментарии

Если точка указывает на неоднозначное расположение, например между двумя строками, в качестве относительной начальной линии выбирается строка в направлении, указанном параметром LogicalDirection. TextPointerIf the TextPointer points to an ambiguous position, for example, between two lines, the line in the direction specified by LogicalDirection is selected as the relative starting line.

Операция, выполняемая этим методом, зависит от допустимого макета.The operation performed by this method depends on a valid layout. При необходимости этот метод пытается автоматически повторно создать допустимый макет, прежде чем продолжить операцию.When necessary, this method attempts to automatically regenerate a valid layout before proceeding with the operation. Повторное создание макета может быть относительно дорогостоящей операцией.Regenerating a layout can be a relatively expensive operation. Используйте HasValidLayout для проверки допустимости макета перед выполнением операций, которые могут повторно создать макет.Use HasValidLayout to check for a valid layout before performing operations that may regenerate the layout. Дополнительные сведения см. в разделе Макет.For more information, see Layout.

GetLineStartPosition(Int32, Int32)

Возвращение TextPointer в начало строки, задаваемое относительно текущего TextPointer, и создание отчета о числе пропущенных строк.Returns a TextPointer to the beginning of a line that is specified relative to the current TextPointer, and reports how many lines were skipped.

public:
 System::Windows::Documents::TextPointer ^ GetLineStartPosition(int count, [Runtime::InteropServices::Out] int % actualCount);
public System.Windows.Documents.TextPointer GetLineStartPosition (int count, out int actualCount);
member this.GetLineStartPosition : int * int -> System.Windows.Documents.TextPointer
Public Function GetLineStartPosition (count As Integer, ByRef actualCount As Integer) As TextPointer

Параметры

count
Int32

Число маркеров начала строки, которые надо пропустить при определении строки, для которой требуется вернуть начальное положение.The number of start-of-line markers to skip when determining the line for which to return the starting position. Отрицательные значения указывают предшествующие строки, 0 задает текущую строку, а положительные значения задают следующие строки.Negative values specify preceding lines, 0 specifies the current line, and positive values specify following lines.

actualCount
Int32

При возврате данный метод включает фактическое число маркеров начала строки, которые были пропущены при определении строки, для которой возвращается начальное положение.When this method returns, contains the actual number of start-of-line markers that were skipped when determining the line for which to return the starting position. Данное значение может оказаться меньше count, если начало или конец содержимого обнаружен до того, как указанное число строк было пропущено.This value may be less than count if the beginning or end of content is encountered before the specified number of lines are skipped. Этот параметр передается неинициализированным.This parameter is passed uninitialized.

Возвраты

TextPointer, указывающий на начало указанной строки (при том, что для LogicalDirection задано значение Forward), или на начало строки, ближайшей к указанной строке, если указанная строка находится вне диапазона.A TextPointer pointing to the beginning of the specified line (with the LogicalDirection set to Forward), or to the beginning of the line closest to the specified line if the specified line is out of range.

Комментарии

Если точка указывает на неоднозначное расположение, например между двумя строками, то строка в направлении, указанном LogicalDirection свойством, выбирается как относительная Начальная строка. TextPointerIf the TextPointer points to an ambiguous position, for example, between two lines, the line in the direction specified by the LogicalDirection property is selected as the relative starting line.

Применяется к