IVsContainedLanguageCodeSupport.EnsureEventHandler(String, String, String, String, UInt32, String, String, TextSpan[]) Méthode

Définition

Crée un gestionnaire d'événement en fonction du contexte de classe, du nom de l'instance de l'objet, du nom de l'événement et du nom (unique) du gestionnaire d'événements, s'il n'en existe aucun.

public:
 int EnsureEventHandler(System::String ^ pszClassName, System::String ^ pszObjectTypeName, System::String ^ pszNameOfEvent, System::String ^ pszEventHandlerName, System::UInt32 itemidInsertionPoint, [Runtime::InteropServices::Out] System::String ^ % pbstrUniqueMemberID, [Runtime::InteropServices::Out] System::String ^ % pbstrEventBody, cli::array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> ^ pSpanInsertionPoint);
int EnsureEventHandler(std::wstring const & pszClassName, std::wstring const & pszObjectTypeName, std::wstring const & pszNameOfEvent, std::wstring const & pszEventHandlerName, unsigned int itemidInsertionPoint, [Runtime::InteropServices::Out] std::wstring const & & pbstrUniqueMemberID, [Runtime::InteropServices::Out] std::wstring const & & pbstrEventBody, std::Array <Microsoft::VisualStudio::TextManager::Interop::TextSpan> const & pSpanInsertionPoint);
public int EnsureEventHandler (string pszClassName, string pszObjectTypeName, string pszNameOfEvent, string pszEventHandlerName, uint itemidInsertionPoint, out string pbstrUniqueMemberID, out string pbstrEventBody, Microsoft.VisualStudio.TextManager.Interop.TextSpan[] pSpanInsertionPoint);
abstract member EnsureEventHandler : string * string * string * string * uint32 * string * string * Microsoft.VisualStudio.TextManager.Interop.TextSpan[] -> int
Public Function EnsureEventHandler (pszClassName As String, pszObjectTypeName As String, pszNameOfEvent As String, pszEventHandlerName As String, itemidInsertionPoint As UInteger, ByRef pbstrUniqueMemberID As String, ByRef pbstrEventBody As String, pSpanInsertionPoint As TextSpan()) As Integer

Paramètres

pszClassName
String

[in] Nom de la classe.

pszObjectTypeName
String

[in] Nom de l'objet.

pszNameOfEvent
String

[in] Nom de l'événement.

pszEventHandlerName
String

[in] Nom du gestionnaire d'événements.

itemidInsertionPoint
UInt32

[in] Fichier ou mémoire tampon où le concepteur souhaite insérer une nouvelle méthode. Il s'agit d'un identificateur unique, d'une des valeurs suivantes : VSITEMID_NIL, VSITEMID_ROOT ou VSITEMID_SELECTION.

pbstrUniqueMemberID
String

[out] Retourne un ID de membre unique pour le gestionnaire d'événements.

pbstrEventBody
String

[out] Retourne le corps de gestionnaire d'événements retourné.

pSpanInsertionPoint
TextSpan[]

[out] Retourne un objet TextSpan décrivant l'emplacement dans le code source dans lequel le gestionnaire d'événements a été inséré.

Retours

Int32

En cas de réussite, retourne S_OK , sinon, retourne un code d'erreur.

Remarques

Signature COM

À partir de singlefileeditor. idl :

HRESULT EnsureEventHandler(  
   [in]  LPCWSTR   pszClassName,  
   [in]  LPCWSTR   pszObjectTypeName,  
   [in]  LPCWSTR   pszNameOfEvent,  
   [in]  LPCWSTR   pszEventHandlerName,  
   [in]  VSITEMID  itemidInsertionPoint,  
   [out] BSTR*     pbstrUniqueMemberID,  
   [out] BSTR*     pbstrEventBody,  
   [out] TextSpan* pSpanInsertionPoint  
);  

Cette méthode retourne le corps du gestionnaire d’événements entier et une représentation sous forme de chaîne qui identifie de façon unique le membre d’événement dans le contexte de classe donné. Dans le cas où le gestionnaire d’événements existe déjà, l’ID de membre unique de ce membre de classe est retourné avec une chaîne NULL pour le corps de l’événement et l’ID de membre.

Le itemidInsertionPoint paramètre indique le fichier/mémoire tampon où le concepteur souhaite placer une nouvelle méthode. Si la méthode n’existe pas, le point d’insertion retourné dans le pSpanInsertionPoint paramètre correspond à la mémoire tampon du demandé itemid .

Notez que cette méthode n’injecte pas le gestionnaire d’événements généré dans la mémoire tampon secondaire ou dans le fichier de classe partielle, uniquement dans la mémoire tampon principale.

S’applique à