IVsContainedLanguageCodeSupport.EnsureEventHandler(String, String, String, String, UInt32, String, String, TextSpan[]) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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.