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 CDataPathProperty
remplacez 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