Compartilhar via

Classe CDataPathProperty

  • Artigo

Implementa uma propriedade de controle OLE que pode ser carregada de maneira assíncrona.

Sintaxe

class CDataPathProperty : public CAsyncMonikerFile

Membros

Construtores públicos

Nome Descrição
CDataPathProperty::CDataPathProperty Constrói um objeto CDataPathProperty.

Métodos públicos

Nome Descrição
CDataPathProperty::GetControl Recupera o controle OLE assíncrono associado ao objeto CDataPathProperty.
CDataPathProperty::GetPath Recupera o nome do caminho da propriedade.
CDataPathProperty::Open Inicia o carregamento da propriedade assíncrona para o controle ActiveX (OLE) associado.
CDataPathProperty::ResetData Chama CAsyncMonikerFile::OnDataAvailable para notificar o contêiner de que as propriedades de controle foram alteradas.
CDataPathProperty::SetControl Define o controle OLE (ActiveX assíncrono) associado à propriedade.
CDataPathProperty::SetPath Define o nome do caminho da propriedade.

Comentários

As propriedades assíncronas são carregadas após a iniciação síncrona.

A classe CDataPathProperty é derivada de CAysncMonikerFile. Para implementar propriedades assíncronas em seus controles OLE, derive uma classe de CDataPathProperty e substitua OnDataAvailable.

Para obter mais informações sobre como usar monikers assíncronos e controles ActiveX em aplicativos da Internet, confira os seguintes artigos:

Hierarquia de herança

CObject

CFile

COleStreamFile

CMonikerFile

CAsyncMonikerFile

CDataPathProperty

Requisitos

Cabeçalho: afxctl.h

CDataPathProperty::CDataPathProperty

Constrói um objeto CDataPathProperty.

CDataPathProperty(COleControl* pControl = NULL);
CDataPathProperty(LPCTSTR lpszPath, COleControl* pControl = NULL);

Parâmetros

pControle
Um ponteiro para o objeto de controle OLE a ser associado a esse objeto CDataPathProperty.

lpszPath
O caminho, que pode ser absoluto ou relativo, usado para criar um moniker assíncrono que faz referência ao local absoluto real da propriedade. CDataPathProperty usa URLs, não nomes de arquivo. Se você quiser um objeto CDataPathProperty para um arquivo, preceda file:// ao caminho.

Comentários

O objeto COleControl apontado por pControl é usado por Open e recuperado por classes derivadas. Se pControl for NULL, o controle usado com Open deve ser definido com SetControl. Se lpszPath for NULL, você poderá passar o caminho por Open ou defini-lo com SetPath.

CDataPathProperty::GetControl

Chame essa função membro para recuperar o objeto COleControl associado ao objeto CDataPathProperty.

COleControl* GetControl();

Valor de retorno

Retorna um ponteiro para o controle OLE associado ao objeto CDataPathProperty. NULL se o controle não estiver associado.

CDataPathProperty::GetPath

Chame essa função membro para recuperar o caminho, definir quando o objeto CDataPathProperty foi construído ou especificado em Open ou, ainda, especificado uma chamada anterior para a função membro SetPath.

CString GetPath() const;

Valor de retorno

Retorna o nome do caminho para a propriedade em si. Pode ficar vazio se nenhum caminho tiver sido especificado.

CDataPathProperty::Open

Chame essa função membro para iniciar o carregamento da propriedade assíncrona para o controle associado.

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);

Parâmetros

pControle
Um ponteiro para o objeto de controle OLE a ser associado a esse objeto CDataPathProperty.

pError
Um ponteiro para uma exceção de arquivo. No caso de um erro, ele será definido como a causa.

lpszPath
O caminho, que pode ser absoluto ou relativo, usado para criar um moniker assíncrono que faz referência ao local absoluto real da propriedade. CDataPathProperty usa URLs, não nomes de arquivo. Se você quiser um objeto CDataPathProperty para um arquivo, preceda file:// ao caminho.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

A função tenta obter a interface IBindHost do controle.

Antes de chamar Open sem um caminho, o valor do caminho da propriedade deve ser definido. Isso pode ser feito quando o objeto é construído ou chamando a função membro SetPath.

Antes de chamar Open sem um controle, um controle ActiveX (anteriormente conhecido como controle OLE) pode ser associado ao objeto. Isso pode ser feito quando o objeto é construído ou chamando SetControl.

Todas as sobrecargas de CAsyncMonikerFile::Open também estão disponíveis em CDataPathProperty.

CDataPathProperty::ResetData

Chame essa função para obter CAsyncMonikerFile::OnDataAvailable para notificar o contêiner de que as propriedades de controle foram alteradas e todas as informações carregadas de forma assíncrona não são mais úteis.

virtual void ResetData();

Comentários

A abertura deve ser reiniciada. Classes derivadas podem substituir essa função por padrões diferentes.

CDataPathProperty::SetControl

Chame essa função de membro para associar um controle OLE assíncrono ao objeto CDataPathProperty.

void SetControl(COleControl* pControl);

Parâmetros

pControle
Um ponteiro para o controle OLE assíncrono a ser associado à propriedade.

CDataPathProperty::SetPath

Chame essa função membro para definir o nome do caminho da propriedade.

void SetPath(LPCTSTR lpszPath);

Parâmetros

lpszPath
Um caminho, que pode ser absoluto ou relativo, para a propriedade que está sendo carregada de forma assíncrona. CDataPathProperty usa URLs, não nomes de arquivo. Se você quiser um objeto CDataPathProperty para um arquivo, preceda file:// ao caminho.

Confira também

Imagem de exemplo do MFC
Classe CAsyncMonikerFile
Gráfico da hierarquia
Classe CAsyncMonikerFile