Partager via


Afficher les fichiers à l'aide de la commande de fichier ouvert

Les étapes suivantes décrivent comment l'IDE gère la commande d' Ouvrir un fichier , qui est disponible dans le menu de Fichier dans Visual Studio. Les étapes indiquent également comment les projets doivent satisfaire aux appels provenant de cette commande.

Lorsqu'un utilisateur clique sur la commande d' Ouvrir un fichier dans le menu de Fichier , et sélectionne un fichier de la boîte de dialogue d' Ouvrir un fichier , le processus suivant se produit.

  1. À l'aide de le tableau en cours de exécution de document, l'IDE détermine si le fichier est déjà ouvert dans un projet.

    • Si le fichier est ouvert, l'IDE reblanchit la fenêtre.

    • Si le fichier n'est pas ouvert, l'IDE appelle l' IsDocumentInProject pour interroger chaque projet de déterminer le projet peut ouvrir le fichier.

      Notes

      Dans votre mise en ? uvre de projet d' IsDocumentInProject, fournissez une valeur de priorité qui indique le niveau auquel votre projet ouvre le fichier.Les valeurs de priorité sont fournies dans l'énumération d' VSDOCUMENTPRIORITY .

  2. Chaque projet répond à un niveau de priorité qui indique l'importance qu'il place pour être le projet pour ouvrir le fichier.

  3. L'IDE utilise les critères suivants pour déterminer le projet ouvre le fichier :

    • Le projet qui répond à la priorité la plus élevée (DP_Intrinsic) ouvre le fichier. Si plusieurs projets répond à cette priorité, le premier projet pour répondre ouvre le fichier.

    • Si aucun projet ne répond à la priorité la plus élevée (DP_Intrinsic), mais les projets répondent de même, la priorité plus basse, le projet actif ouvre le fichier. Si aucun projet n'est actif, le premier projet pour répondre ouvre le fichier.

    • Si aucun projet ne fait la propriété du fichier (DP_Unsupported), le projet Fichiers divers ouvre le fichier.

      Si une instance du projet Fichiers divers est créée, le projet continue avec la valeur DP_CanAddAsExternal. cette valeur indique que le projet peut ouvrir le fichier. Ce projet est utilisé de recevoir les fichiers ouverts qui ne sont pas dans un autre projet. La liste d'éléments de ce projet n'est pas rendu persistant ; ce projet est visible dans Explorateur de solutions uniquement lorsqu'il est utilisé pour ouvrir un fichier.

      Si le projet Fichiers divers n'indique pas qu'il peut ouvrir le fichier, une instance de projet n'a été créée. Dans ce cas, l'IDE crée une instance du projet Fichiers divers et indique le projet pour ouvrir le fichier.

  4. Dès que l'IDE détermine quel projet ouvre le fichier, il appelle la méthode d' OpenItem sur ce projet.

  5. Le projet possède alors l'option pour ouvrir le fichier à l'aide d'un éditeur spécifique au projet ou d'un éditeur standard. Pour plus d'informations, consultez Comment : Ouvrez les éditeurs spécifiques au projet et Comment : Éditeurs de norme ouverte respectivement.

Voir aussi

Tâches

Comment : Ouvrez les éditeurs spécifiques au projet

Comment : Éditeurs de norme ouverte

Concepts

Afficher des fichiers à l'aide de l'ouvrir avec la commande

Autres ressources

Éléments de projet d'ouverture et d'enregistrement