IVsTextLines.GetLineData-Methode

Artikel
05/16/2015

Bietet direkten, Zeile-ausgerichteten Zugriff auf den Textpuffer.

Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)

Syntax

'Declaration
Function GetLineData ( _
    iLine As Integer, _
    <OutAttribute> pLineData As LINEDATA(), _
    pMarkerData As MARKERDATA() _
) As Integer

int GetLineData(
    int iLine,
    LINEDATA[] pLineData,
    MARKERDATA[] pMarkerData
)

int GetLineData(
    [InAttribute] int iLine, 
    [OutAttribute] array<LINEDATA>^ pLineData, 
    [InAttribute] array<MARKERDATA>^ pMarkerData
)

abstract GetLineData : 
        iLine:int * 
        pLineData:LINEDATA[] byref * 
        pMarkerData:MARKERDATA[] -> int

function GetLineData(
    iLine : int, 
    pLineData : LINEDATA[], 
    pMarkerData : MARKERDATA[]
) : int

Parameter

iLine
Typ: Int32

[in] Zuzugreifen Puffer. Dies ist ein nullbasierter Wert.

pLineData
Typ: array<Microsoft.VisualStudio.TextManager.Interop.LINEDATA[]

[in, out] Die ausgefüllte LINEDATA Struktur. Dies wird vom Aufrufer zugeordnet und ausgefüllt von der GetLineData-Methode.

pMarkerData
Typ: array<Microsoft.VisualStudio.TextManager.Interop.MARKERDATA[]

[in, optional] MARKERDATA Struktur. Verwenden Sie GetMarkerData , um die Zeilen MARKERDATA Struktur für den Bereich auszufüllen, den Sie angeben. Wenn Sie Syntaxfarben- und Marker LINEDATA-Attribute in der Struktur (pLineData) zurückkehren möchten, müssen Sie in diesen Parameter übergeben.

Rückgabewert

Typ: Int32
Wenn die Methode erfolgreich ausgeführt, gibt sie S_OKzurück.Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

Von textmgr.idl:

HRESULT IVsTextLines::GetLineData(
   [in] long iLine,
   [out] LINEDATA *pLineData,
   [in] MARKERDATA *pMarkerData
);

Wenn Sie IVsTextLines.GetLineData aufrufen, wird ein Zeiger auf die internen Daten des Puffers zu gewährleisten. Sie können diese Methode nur verwenden, um jeweils eine Zeile im Puffer zuzugreifen.

Diese Methode gibt die Daten für die Zeile in einer LINEDATA Struktur zurück und kann schnell zur Überprüfung verwendet werden, den Inhalt eines Puffers. Wenn Sie den zeilenweise Text lesen möchten, ist es viel schneller als LINEDATA abzurufen und zu lesen, das Methoden CopyLineText oder - GetLineTextaufzurufen.

Hinweis

IVsTextLines.GetLineData verwendet Zeiger auf die internen Daten des Puffers.Der Puffer wird gesperrt, bis die ReleaseLineData-Methode aufgerufen wird.Jeder erfolgreichen Aufruf von GetLineData muss ReleaseLineData mit demselben LINEDATA Zeiger aufrufen.Der Parameter pMarkerData, wenn nicht NULL, gibt an, dass die Attributdaten auch angefordert wird.Der angegebene pMarkerData muss durch einen vorherigen Aufruf der GetMarkerData-Methode abgerufen werden.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

IVsTextLines Schnittstelle

Microsoft.VisualStudio.TextManager.Interop-Namespace

Freigeben über