Share via

CDataPathProperty, classe

  • Article

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

CObject

CFile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

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