Partager via

Propriété Application.HinstancePtr (Excel)

  • Article

Retourne un handle à l’instance d’Excel représentée par l’objet Application spécifié. Variant en lecture seule.

Syntaxe

expression. HinstancePtr

expressionUne variable qui représente un objetApplication.

Remarques

Cette propriété retourne un handle correct dans les versions 32 bits et 64 bits d’Excel. Il étend les fonctionnalités de la propriété Hinstance de l’objet Application , qui fonctionne uniquement correctement dans la version 32 bits d’Excel.

Le type de données idéal à utiliser avec cette propriété est le type de données LongPtr . L’affectation de la valeur retournée par cette propriété à une variable LongPtr fonctionnera comme prévu dans les versions 32 bits et 64 bits d’Excel. La propriété est définie en tant que Variant pour des raisons d’implémentation interne. Cependant, elle renvoie toujours une valeur 32 bits sur des systèmes 32 bits et une valeur 64 bits sur des systèmes 64 bits.

Cette propriété fonctionne uniquement à partir d’Excel et n’est requise qu’avec la version 64 bits d’Excel. Si vous devez écrire du code qui fonctionnera également avec des versions antérieures d’Excel, afin d’éviter les erreurs de compilation, lisez cette propriété sous une #if Win64 directive de compilation conditionnelle et utilisez la propriété Hinstance sous la #else directive .

Notez que cette propriété fonctionne correctement dans les environnements 32 bits et 64 bits à partir d’Excel. Par conséquent, si votre code est destiné à être utilisé uniquement avec Excel ou version ultérieure, 32 bits ou 64 bits, il peut lire cette propriété sans compilation conditionnelle.

Pour plus d’informations sur l’utilisation de VBA dans les environnements 64 bits, consultez Vue d’ensemble de Visual Basic pour Applications 64 bits.

Exemple

Dans cet exemple, une boîte de message affiche le handle d’instance Excel pour l’utilisateur.

Sub CheckHinstance() 
    MsgBox Application.HinstancePtr 
End Sub

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.