CDataPathProperty, classe
Implémente une propriété de contrôle OLE qui peut être chargée de façon asynchrone.
Syntaxe
class CDataPathProperty : public CAsyncMonikerFile
Membres
Constructeurs publics
| Nom | Description |
|---|---|
| CDataPathProperty ::CDataPathProperty | Construit un objet CDataPathProperty. |
Méthodes publiques
| Nom | Description |
|---|---|
| CDataPathProperty ::GetControl | Récupère le contrôle OLE asynchrone associé à l’objet CDataPathProperty . |
| CDataPathProperty ::GetPath | Récupère le chemin d’accès de la propriété. |
| CDataPathProperty ::Open | Lance le chargement de la propriété asynchrone pour le contrôle ActiveX (OLE) associé. |
| CDataPathProperty ::ResetData | Appels CAsyncMonikerFile::OnDataAvailable pour avertir le conteneur que les propriétés du contrôle ont changé. |
| CDataPathProperty ::SetControl | Définit le contrôle ActiveX asynchrone (OLE) associé à la propriété. |
| CDataPathProperty ::SetPath | Définit le chemin d’accès de la propriété. |
Notes
Les propriétés asynchrones sont chargées après le lancement synchrone.
La classe CDataPathProperty est dérivée de CAysncMonikerFile. Pour implémenter des propriétés asynchrones dans vos contrôles OLE, dérivez une classe et CDataPathPropertyremplacez OnDataAvailable.
Pour plus d’informations sur l’utilisation de monikers asynchrones et de contrôles ActiveX dans des applications Internet, consultez les articles suivants :
Hiérarchie d'héritage
CDataPathProperty
Spécifications
En-tête : afxctl.h
CDataPathProperty ::CDataPathProperty
Construit un objet CDataPathProperty.
CDataPathProperty(COleControl* pControl = NULL);
CDataPathProperty(LPCTSTR lpszPath, COleControl* pControl = NULL);
Paramètres
pControl
Pointeur vers l’objet de contrôle OLE à associer à cet CDataPathProperty objet.
lpszPath
Chemin d’accès, qui peut être absolu ou relatif, utilisé pour créer un moniker asynchrone qui référence l’emplacement absolu réel de la propriété. CDataPathProperty utilise des URL, et non des noms de fichiers. Si vous souhaitez qu’un CDataPathProperty objet pour un fichier soit ajouté file:// au chemin d’accès.
Notes
L’objet COleControl pointé par pControl est utilisé par Open et récupéré par des classes dérivées. Si pControl a la valeur NULL, le contrôle utilisé Open doit être défini avec SetControl. Si lpszPath a la valeur NULL, vous pouvez passer le chemin d’accès Open ou le définir avec SetPath.
CDataPathProperty ::GetControl
Appelez cette fonction membre pour récupérer l’objet COleControl associé à l’objet CDataPathProperty .
COleControl* GetControl();
Valeur de retour
Retourne un pointeur vers le contrôle OLE associé à l’objet CDataPathProperty . NULL si le contrôle n’est pas associé.
CDataPathProperty ::GetPath
Appelez cette fonction membre pour récupérer le chemin d’accès, définir lorsque l’objet CDataPathProperty a été construit ou spécifié dans Open, ou spécifié dans un appel précédent à la SetPath fonction membre.
CString GetPath() const;
Valeur de retour
Retourne le chemin d’accès à la propriété elle-même. Peut être vide si aucun chemin d’accès n’a été spécifié.
CDataPathProperty ::Open
Appelez cette fonction membre pour lancer le chargement de la propriété asynchrone pour le contrôle associé.
virtual BOOL Open(
COleControl* pControl,
CFileException* pError = NULL);
virtual BOOL Open(
LPCTSTR lpszPath,
COleControl* pControl,
CFileException* pError = NULL);
virtual BOOL Open(
LPCTSTR lpszPath,
CFileException* pError = NULL);
virtual BOOL Open(CFileException* pError = NULL);
Paramètres
pControl
Pointeur vers l’objet de contrôle OLE à associer à cet CDataPathProperty objet.
pError
Pointeur vers une exception de fichier. En cas d’erreur, est défini sur la cause.
lpszPath
Chemin d’accès, qui peut être absolu ou relatif, utilisé pour créer un moniker asynchrone qui référence l’emplacement absolu réel de la propriété. CDataPathProperty utilise des URL, et non des noms de fichiers. Si vous souhaitez qu’un CDataPathProperty objet pour un fichier soit ajouté file:// au chemin d’accès.
Valeur de retour
Valeur différente de zéro cas de réussite ; sinon, 0.
Notes
La fonction tente d’obtenir l’interface IBindHost du contrôle.
Avant d’appeler Open sans chemin d’accès, la valeur du chemin d’accès de la propriété doit être définie. Pour ce faire, lorsque l’objet est construit ou en appelant la SetPath fonction membre.
Avant d’appeler Open sans contrôle, un contrôle ActiveX (anciennement appelé contrôle OLE) peut être associé à l’objet. Pour ce faire, lorsque l’objet est construit ou en appelant SetControl.
Toutes les surcharges de CAsyncMonikerFile ::Open sont également disponibles à partir de CDataPathProperty.
CDataPathProperty ::ResetData
Appelez cette fonction pour avertir CAsyncMonikerFile::OnDataAvailable le conteneur que les propriétés du contrôle ont changé, et toutes les informations chargées de manière asynchrone ne sont plus utiles.
virtual void ResetData();
Notes
L’ouverture doit être redémarrée. Les classes dérivées peuvent remplacer cette fonction pour différentes valeurs par défaut.
CDataPathProperty ::SetControl
Appelez cette fonction membre pour associer un contrôle OLE asynchrone à l’objet CDataPathProperty .
void SetControl(COleControl* pControl);
Paramètres
pControl
Pointeur vers le contrôle OLE asynchrone à associer à la propriété.
CDataPathProperty ::SetPath
Appelez cette fonction membre pour définir le chemin d’accès de la propriété.
void SetPath(LPCTSTR lpszPath);
Paramètres
lpszPath
Chemin d’accès, qui peut être absolu ou relatif, à la propriété chargée de manière asynchrone. CDataPathProperty utilise des URL, et non des noms de fichiers. Si vous souhaitez qu’un CDataPathProperty objet pour un fichier soit ajouté file:// au chemin d’accès.
Voir aussi
Exemple d’image MFC
CAsyncMonikerFile, classe
Graphique hiérarchique
CAsyncMonikerFile, classe