Classe COleChangeSourceDialog
Usado para a caixa de diálogo Fonte de Alteração OLE.
Sintaxe
class COleChangeSourceDialog : public COleDialog
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| COleChangeSourceDialog::COleChangeSourceDialog | Constrói um objeto COleChangeSourceDialog. |
Métodos públicos
| Nome | Descrição |
|---|---|
| COleChangeSourceDialog::DoModal | Exibe a caixa de diálogo OLE Alterar origem. |
| COleChangeSourceDialog::GetDisplayName | Obtém o nome de exibição de origem completo. |
| COleChangeSourceDialog::GetFileName | Obtém o nome de arquivo do nome de origem. |
| COleChangeSourceDialog::GetFromPrefix | Obtém o prefixo da origem anterior. |
| COleChangeSourceDialog::GetItemName | Obtém o nome de item do nome de origem. |
| COleChangeSourceDialog::GetToPrefix | Obtém o prefixo da nova origem |
| COleChangeSourceDialog::IsValidSource | Indica se a origem é válida. |
Membros de Dados Públicos
| Nome | Descrição |
|---|---|
| COleChangeSourceDialog::m_cs | Uma estrutura que controla o comportamento da caixa de diálogo. |
Comentários
Crie um objeto da classe COleChangeSourceDialog quando quiser chamar essa caixa de diálogo. Depois que um objeto COleChangeSourceDialog for construído, você poderá usar a estrutura m_cs para inicializar os valores ou estados dos controles na caixa de diálogo. A estrutura m_cs é do tipo OLEUICHANGESOURCE. Para mais informações sobre como usar essa classe de diálogo, confira a função membro DoModal.
Para mais informações, confira a estrutura OLEUICHANGESOURCE no SDK do Windows.
Para mais informações sobre caixas de diálogo específicas do OLE, confira o artigo Caixas de diálogo no OLE.
Hierarquia de herança
COleChangeSourceDialog
Requisitos
Cabeçalho: afxodlgs.h
COleChangeSourceDialog::COleChangeSourceDialog
Essa função constrói um objeto COleChangeSourceDialog.
explicit COleChangeSourceDialog(
COleClientItem* pItem,
CWnd* pParentWnd = NULL);
Parâmetros
pItem
Ponteiro para o COleClientItem vinculado cuja origem deve ser atualizada.
pParentWnd
Aponta para o objeto de janela pai ou proprietário (do tipo CWnd) ao qual o objeto de caixa de diálogo pertence. Se for NULL, a janela pai da caixa de diálogo será definida como a janela principal do aplicativo.
Comentários
Para exibir a caixa de diálogo, chame a função DoModal.
Para obter mais informações, consulte a estrutura OLEUICHANGESOURCE e a função OleUIChangeSource no SDK do Windows.
COleChangeSourceDialog::DoModal
Chame essa função para exibir a caixa de diálogo OLE Alterar origem.
virtual INT_PTR DoModal();
Valor de retorno
Status de conclusão da caixa de diálogo. Um dos seguintes valores:
IDOK se a caixa de diálogo foi exibida com êxito.
IDCANCEL se o usuário cancelou a caixa de diálogo.
IDABORT se ocorreu um erro. Se IDABORT for retornado, chame a função membro COleDialog::GetLastError para obter mais informações sobre o tipo de erro que ocorreu. Para obter uma lista de possíveis erros, confira a função OleUIChangeSource no SDK do Windows.
Comentários
Se você quiser inicializar os vários controles da caixa de diálogo definindo membros da estrutura m_cs, faça isso antes de chamar DoModal, mas depois que o objeto de caixa de diálogo for construído.
Se DoModal retornar IDOK, você poderá chamar funções membro para recuperar as configurações ou informações inseridas pelo usuário a partir da caixa de diálogo. A lista a seguir nomeia funções de consulta típicas.
COleChangeSourceDialog::GetDisplayName
Chame essa função para recuperar o nome de exibição completo do item de cliente vinculado.
CString GetDisplayName();
Valor de retorno
O nome de exibição de origem completo (moniker) para o COleClientItem especificado no construtor.
COleChangeSourceDialog::GetFileName
Chame essa função para recuperar a parte do moniker de arquivo do nome de exibição do item de cliente vinculado.
CString GetFileName();
Valor de retorno
A parte do moniker de arquivo do nome de exibição de origem para o COleClientItem especificado no construtor.
Comentários
O moniker de arquivo junto com o moniker de item fornecem o nome de exibição completo.
COleChangeSourceDialog::GetFromPrefix
Chame essa função para obter a cadeia de caracteres de prefixo anterior para a origem.
CString GetFromPrefix();
Valor de retorno
A cadeia de caracteres de prefixo anterior da origem.
Comentários
Chame essa função somente depois que DoModal retornar IDOK.
Esse valor vem diretamente do membro lpszFrom da estrutura OLEUICHANGESOURCE.
Para mais informações, confira a estrutura OLEUICHANGESOURCE no SDK do Windows.
COleChangeSourceDialog::GetItemName
Chame essa função para recuperar a parte do moniker de item do nome de exibição do item de cliente vinculado.
CString GetItemName();
Valor de retorno
A parte do moniker de item do nome de exibição de origem para o COleClientItem especificado no construtor.
Comentários
O moniker de arquivo junto com o moniker de item fornecem o nome de exibição completo.
COleChangeSourceDialog::GetToPrefix
Chame essa função para obter a nova cadeia de caracteres de prefixo para a origem.
CString GetToPrefix();
Valor de retorno
A nova cadeia de caracteres de prefixo da origem.
Comentários
Chame essa função somente depois que DoModal retornar IDOK.
Esse valor vem diretamente do membro lpszTo da estrutura OLEUICHANGESOURCE.
Para mais informações, confira a estrutura OLEUICHANGESOURCE no SDK do Windows.
COleChangeSourceDialog::m_cs
Esse membro de dados é uma estrutura do tipo OLEUICHANGESOURCE.
OLEUICHANGESOURCE m_cs;
Comentários
OLEUICHANGESOURCE é usado para controlar o comportamento da caixa de diálogo OLE Alterar origem. Os membros dessa estrutura podem ser modificados diretamente.
Para mais informações, confira a estrutura OLEUICHANGESOURCE no SDK do Windows.
COleChangeSourceDialog::IsValidSource
Chame essa função para determinar se a nova origem é válida.
BOOL IsValidSource();
Valor de retorno
Não zero se a nova origem for válida, caso contrário, 0.
Comentários
Chame essa função somente depois que DoModal retornar IDOK.
Para mais informações, confira a estrutura OLEUICHANGESOURCE no SDK do Windows.