Share via


CWinApp::RegisterShellFileTypes

Appelez la fonction membre pour stocker tous les types de document de votre application avec le gestionnaire de fichiers windows.

void RegisterShellFileTypes(
   BOOL bCompat = FALSE 
);

Paramètres

  • [in] bCompat
    TRUE ajoute des entrées d'inscription pour les commandes d'environnement copie et copie la valeur, ce qui permet un utilisateur aux fichiers d'impression directement du shell, ou en faisant glisser le fichier vers un objet d'imprimante. Il ajoute également une clé de DefaultIcon. Par défaut, ce paramètre est FALSE pour la compatibilité descendante.

Notes

Cela permet à l'utilisateur d'ouvrir un fichier de données créé par votre application en double-cliquant sur le gestionnaire de fichiers. Appel RegisterShellFileTypes après avoir appelé AddDocTemplate pour chacun des modèles de document dans votre application. Appelle également la fonction membre d' EnableShellOpen lorsque vous appelez RegisterShellFileTypes.

RegisterShellFileTypes itère au sein de la liste de CDocTemplate objets que l'application met à jour et, pour chaque modèle de document, ajoute des entrées dans la base de données d'inscription que windows gère des associations de fichiers. Le gestionnaire de fichiers utilise ces entrées pour ouvrir un fichier de données lorsque l'utilisateur le double-cliquez sur. Cela élimine la nécessité d'expédier un fichier de .REG avec votre application.

Notes

RegisterShellFileTypes s'exécute uniquement si l'utilisateur lance le programme avec des droits d'administrateur.Si le programme n'a pas de droits d'administrateur, il ne peut pas modifier les clés de Registre.

Si la base de données d'inscription associe déjà une extension de nom de fichier spécifiée avec un autre type de fichier, aucune nouvelle association n'est créée. Consultez la classe d' CDocTemplate pour le format des chaînes nécessaires pour stocker ces informations.

Configuration requise

en-tête: afxwin.h

Voir aussi

Référence

CWinApp, classe

Graphique de la hiérarchie

CDocTemplate, classe

CWinApp::EnableShellOpen

CWinApp::AddDocTemplate