Metodo IVsLanguageTextOps.Format
Formattare il testo selezionato.
Spazio dei nomi: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)
Sintassi
'Dichiarazione
Function Format ( _
pTextLayer As IVsTextLayer, _
ptsSel As TextSpan() _
) As Integer
int Format(
IVsTextLayer pTextLayer,
TextSpan[] ptsSel
)
int Format(
[InAttribute] IVsTextLayer^ pTextLayer,
[InAttribute] array<TextSpan>^ ptsSel
)
abstract Format :
pTextLayer:IVsTextLayer *
ptsSel:TextSpan[] -> int
function Format(
pTextLayer : IVsTextLayer,
ptsSel : TextSpan[]
) : int
Parametri
pTextLayer
Tipo: Microsoft.VisualStudio.TextManager.Interop.IVsTextLayer[in] IVsTextLayer oggetto contenente il testo nel formato.
ptsSel
Tipo: array<Microsoft.VisualStudio.TextManager.Interop.TextSpan[][in] Intervallo di testo da formattare all'interno del livello specificato. Per ulteriori informazioni, vedere TextSpan.
Valore restituito
Tipo: Int32
Se il metodo ha esito positivo, restituisce S_OK.Se non riesce, restituisce un codice di errore.
Note
Firma COM
da textmgr.idl:
HRESULT IVsLanguageTextOps::Format(
[in] IVsTextLayer *pTextLayer,
[in] const TextSpan *ptsSel
);
Questa funzione viene chiamata quando l'utente seleziona documento di formato o selezione di formato da modifica - > avanzato menu e richiede al servizio di linguaggio fornisce la formattazione per l'intervallo di testo a cui si fa riferimento. Formattare indica in genere a regolare il rientro di una riga, spazi di aggiunta dopo virgole, o addirittura le parentesi graffe lo spostamento in una nuova riga con il rientro appropriato.
Questo metodo può essere chiamato ogni volta che l'utente digita un carattere che potrebbe generare un formattazione (che il carattere dipende dal servizio di linguaggio ma in genere è una parentesi graffa di chiusura o un punto e virgola).
Nota
È consigliabile se si distribuisce questo metodo, si esegue il wrapping di tutte le modifiche apportate al documento in IVsCompoundAction l'oggetto in modo che l'utente possa annullare l'intera operazione di formattazione in un'azione.
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.