Classe COleChangeSourceDialog

Usado para a caixa de diálogo OLE Change Source.

Sintaxe

class COleChangeSourceDialog : public COleDialog

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados Públicos

Observações

Cria um objeto de classe COleChangeSourceDialog quando quiseres chamar esta caixa de diálogo. Depois de um COleChangeSourceDialog objeto ter sido construído, pode usar a estrutura m_cs para inicializar os valores ou estados dos controlos na caixa de diálogo. A m_cs estrutura é do tipo OLEUICHANGESOURCE. Para mais informações sobre a utilização desta classe de diálogo, consulte a função membro DoModal .

Para mais informações, consulte a estrutura OLEUICHANGESOURCE no Windows SDK.

Para mais informações sobre caixas de diálogo específicas de OLE, consulte o artigo Caixas de Diálogo em OLE.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleChangeSourceDialog

Requerimentos

Cabeçalho: afxodlgs.h

COleChangeSourceDialogue::COleChangeSourceDialogue

Esta função constrói um COleChangeSourceDialog objeto.

explicit COleChangeSourceDialog(
    COleClientItem* pItem,
    CWnd* pParentWnd = NULL);

Parâmetros

pItem
Apontar para o COleClientItem ligado cuja fonte deve ser atualizada.

pParentWnd
Aponta para o objeto janela pai ou proprietário (do tipo CWnd) ao qual pertence o objeto de diálogo. Se for NULL, a janela principal da caixa de diálogo será definida como a janela principal da aplicação.

Observações

Para mostrar a caixa de diálogo, chame a função DoModal .

Para mais informações, consulte a estrutura OLEUICHANGESOURCE e a função OleUIChangeSource no SDK do Windows.

COleChangeSourceDialog::D oModal

Chame esta função para mostrar a caixa de diálogo OLE Change Source.

virtual INT_PTR DoModal();

Valor de retorno

Estado de conclusão da caixa de diálogo. Um dos seguintes valores:

• Não sei se a caixa de diálogo foi exibida com sucesso.

• IDCANCEL se o utilizador cancelou a caixa de diálogo.

• IDABORT se ocorresse um erro. Se o IDABORT for devolvido, chame a função membro COleDialog::GetLastError para obter mais informações sobre o tipo de erro que ocorreu. Para uma lista de possíveis erros, consulte a função OleUIChangeSource no Windows SDK.

Observações

Se quiseres inicializar os vários controlos das caixas de diálogo definindo membros da estrutura m_cs , deves fazer isto antes de chamar DoModal, mas depois de o objeto de diálogo estar construído.

Se DoModal devolver IDOK, pode chamar funções membros para recuperar definições ou informações introduzidas pelo utilizador na caixa de diálogo. As seguintes listas nomeam funções de consulta típicas:

• GetFileName

• GetDisplayName

• GetItemName

ColeChangeSourceDialogue::GetDisplayName

Chame esta função para recuperar o nome de exibição completo do item cliente ligado.

CString GetDisplayName();

Valor de retorno

O nome de exibição completo da fonte (moniker) para o COleClientItem especificado no construtor.

ColeChangeSourceDialog::GetFileName

Chame esta função para recuperar a parte do moniker do ficheiro do nome de exibição do item cliente ligado.

CString GetFileName();

Valor de retorno

A parte do nome de ficheiro do nome de exibição de origem para o COleClientItem especificada no construtor.

Observações

O nome do ficheiro, juntamente com o nome do item, fornece o nome completo de visualização.

ColeChangeSourceDialog::GetFromPrefix

Chame esta função para obter a cadeia de prefixos anterior para a fonte.

CString GetFromPrefix();

Valor de retorno

A cadeia de prefixos anterior da fonte.

Observações

Chame esta função apenas depois de o DoModal devolver IDOK.

Este valor provém diretamente do lpszFrom membro da estrutura OLEUICHANGESOURCE .

Para mais informações, consulte a estrutura OLEUICHANGESOURCE no Windows SDK.

ColeChangeSourceDialog::GetItemName

Chame esta função para recuperar a parte do nome de exibição do item do cliente ligado.

CString GetItemName();

Valor de retorno

A parte do nome do item do nome de exibição fonte para o COleClientItem especificada no construtor.

Observações

O nome do ficheiro, juntamente com o nome do item, fornece o nome completo de visualização.

ColeChangeSourceDialog::GetToPrefix

Chame esta função para obter a nova cadeia de prefixos para a fonte.

CString GetToPrefix();

Valor de retorno

A nova cadeia de prefixos da fonte.

Observações

Chame esta função apenas depois de o DoModal devolver IDOK.

Este valor provém diretamente do lpszTo membro da estrutura OLEUICHANGESOURCE .

Para mais informações, consulte a estrutura OLEUICHANGESOURCE no Windows SDK.

ColeChangeSourceDialogue::m_cs

Este membro de dados é uma estrutura do tipo OLEUICHANGESOURCE.

OLEUICHANGESOURCE m_cs;

Observações

OLEUICHANGESOURCE é usado para controlar o comportamento da caixa de diálogo OLE Change Source. Os membros desta estrutura podem ser modificados diretamente.

Para mais informações, consulte a estrutura OLEUICHANGESOURCE no Windows SDK.

ColeChangeSourceDialogue::IsValidSource

Chame esta função para determinar se a nova fonte é válida.

BOOL IsValidSource();

Valor de retorno

Diferente de zero se a nova fonte for válida, caso contrário 0.

Observações

Chame esta função apenas depois de o DoModal devolver IDOK.

Para mais informações, consulte a estrutura OLEUICHANGESOURCE no Windows SDK.

Consulte também

Classe COleDialog
Gráfico de Hierarquia
Classe COleDialog