Classe CDataExchange
Dá suporte às rotinas de DDX (troca de dados de caixa de diálogo) e DDV (validação de dados de caixa de diálogo) usadas pelas classes do Microsoft Foundation.
Sintaxe
class CDataExchange
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CDataExchange::CDataExchange | Constrói um objeto CDataExchange. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CDataExchange::Fail | Chamado quando a validação falha. Redefine o foco para o controle anterior e gera uma exceção. |
| CDataExchange::PrepareCtrl | Prepara o controle especificado para troca ou validação de dados. Use para controles que não sejam de edição. |
| CDataExchange::PrepareEditCtrl | Prepara o controle de edição especificado para troca ou validação de dados. |
| CDataExchange::PrepareOleCtrl | Prepara o controle OLE especificado para troca ou validação de dados. Use para controles que não sejam de edição. |
Membros de Dados Públicos
| Nome | Descrição |
|---|---|
| CDataExchange::m_bSaveAndValidate | Sinalizador para a direção de DDX e DDV. |
| CDataExchange::m_pDlgWnd | A caixa de diálogo ou a janela onde a troca de dados ocorre. |
Comentários
CDataExchange não tem uma classe base.
Use essa classe se você estiver escrevendo rotinas de troca de dados para tipos de dados ou controles personalizados ou se estiver escrevendo suas próprias rotinas de validação de dados. Para obter mais informações sobre como escrever suas próprias rotinas de DDX e DDV, consulte a Nota Técnica 26. Para obter uma visão geral de DDX e DDV, consulte Troca e validação de dados de caixa de diálogo e Caixas de diálogo.
Um objeto CDataExchange fornece as informações de contexto necessárias para que DDX e DDV ocorram. O sinalizador m_bSaveAndValidate é FALSE quando a DDX é usada para preencher os valores iniciais de controles de caixa de diálogo de membros de dados. O sinalizador m_bSaveAndValidate é TRUE quando a DDX é usada para definir os valores atuais dos controles de caixa de diálogo em membros de dados e quando a DDV é usada para validar os valores de dados. Se a validação de DDV falhar, o procedimento DDV exibirá uma caixa de mensagem explicando o erro de entrada. Em seguida, o procedimento DDV chamará Fail para redefinir o foco para o controle incorreto e lançará uma exceção para interromper o processo de validação.
Hierarquia de herança
CDataExchange
Requisitos
Cabeçalho: afxwin.h
CDataExchange::CDataExchange
Chame essa função membro para construir um objeto CDataExchange.
CDataExchange(
CWnd* pDlgWnd,
BOOL bSaveAndValidate);
Parâmetros
pDlgWnd
Um ponteiro para a janela pai que contém o controle. Normalmente, esse é um objeto derivado do CDialog.
bSaveAndValidate
Se TRUE, esse objeto valida os dados e grava dados dos controles nos membros. Se FALSE, esse objeto moverá dados de membros para controles.
Comentários
Construa você mesmo um objeto CDataExchange para armazenar informações extras no objeto de troca de dados para passar para a função membro CWnd::DoDataExchange da janela.
Exemplo
CYourDataExchange dx(this, FALSE);
try
{
DoDataExchange(&dx);
}
catch (CUserException *pe)
{
// some part of the exchange went wrong
// but the user has already been notified
pe->Delete();
}
CDataExchange::Fail
A estrutura chama essa função membro quando uma operação de DDV (validação de dados de caixa de diálogo) falha.
void Fail();
Comentários
Fail restaura o foco e a seleção para o controle cuja validação falhou (se houver um controle a ser restaurado). Em seguida, Fail gera uma exceção do tipo CUserException para interromper o processo de validação. A exceção faz com que uma caixa de mensagem explicando o erro seja exibida. Depois que a validação de DDV falhar, o usuário poderá reinserir dados no controle incorreto.
Os implementadores de rotinas DDV personalizadas podem chamar Fail de suas rotinas quando uma validação falha.
Para obter mais informações sobre como escrever suas próprias rotinas de DDX e DDV, consulte a Nota Técnica 26. Para obter uma visão geral da DDX e da DDV, consulte Troca e validação de dados da caixa de diálogo e Tópicos da caixa de diálogo.
CDataExchange::m_bSaveAndValidate
Esse sinalizador indica a direção de uma operação de troca de dados de caixa de diálogo (DDX).
BOOL m_bSaveAndValidate;
Comentários
O sinalizador será diferente de zero se o objeto CDataExchange estiver sendo usado para mover dados dos controles de caixa de diálogo para membros de dados da classe de diálogo após o usuário editar os controles. O sinalizador será zero se o objeto estiver sendo usado para inicializar controles de caixa de diálogo de membros de dados da classe de diálogo.
O sinalizador também será diferente de zero durante a DDV (validação de dados de caixa de diálogo).
Para obter mais informações sobre como escrever suas próprias rotinas de DDX e DDV, consulte a Nota Técnica 26. Para obter uma visão geral da DDX e da DDV, consulte Troca e validação de dados da caixa de diálogo e Tópicos da caixa de diálogo.
CDataExchange::m_pDlgWnd
Contém um ponteiro para o objeto CWnd no qual a DDX (troca de dados de caixa de diálogo) ou a DDV (validação) está ocorrendo.
CWnd* m_pDlgWnd;
Comentários
Esse objeto geralmente é um CDialog. Os implementadores de rotinas DDX ou DDV personalizadas podem usar esse ponteiro para obter acesso à janela de caixa de diálogo que contém os controles em que estão operando.
Para obter mais informações sobre como escrever suas próprias rotinas de DDX e DDV, consulte a Nota Técnica 26. Para obter uma visão geral da DDX e da DDV, consulte Troca e validação de dados da caixa de diálogo e Tópicos da caixa de diálogo.
CDataExchange::PrepareCtrl
A estrutura chama essa função membro para preparar o controle especificado para a DDX (troca de dados de caixa de diálogo) e a DDV (validação).
HWND PrepareCtrl(int nIDC);
Parâmetros
nIDC
A ID do controle a ser preparada para DDX ou DDV.
Valor de Devolução
O HWND do controle que está sendo preparado para DDX ou DDV.
Comentários
Use PrepareEditCtrl para editar controles; use essa função membro para todos os outros controles.
A preparação consiste em armazenar o HWND do controle na classe CDataExchange. A estrutura usa esse identificador para restaurar o foco para o controle que estava anteriormente em foco no caso de uma falha de DDX ou DDV.
Os implementadores de rotinas DDX ou DDV personalizadas devem chamar PrepareCtrl para todos os controles não editados para os quais estão trocando dados por meio de DDX ou validando dados por meio de DDV.
Para obter mais informações sobre como escrever suas próprias rotinas de DDX e DDV, consulte a Nota Técnica 26. Para obter uma visão geral da DDX e da DDV, consulte Troca e validação de dados da caixa de diálogo e Tópicos da caixa de diálogo.
CDataExchange::PrepareEditCtrl
A estrutura chama essa função membro para preparar o controle de edição especificado para DDX (troca de dados de caixa de diálogo) e DDV (validação).
HWND PrepareEditCtrl(int nIDC);
Parâmetros
nIDC
A ID do controle de edição a ser preparada para DDX ou DDV.
Valor de Devolução
O HWND do controle de edição que está sendo preparado para DDX ou DDV.
Comentários
Use PrepareCtrl para todos os controles não editados.
A preparação consiste em duas coisas. Primeiro, PrepareEditCtrl armazena o HWND do controle na classe CDataExchange. A estrutura usa esse identificador para restaurar o foco para o controle que estava anteriormente em foco no caso de uma falha de DDX ou DDV. Depois, PrepareEditCtrl define um sinalizador na classe CDataExchange para indicar que o controle cujos dados estão sendo trocados ou validados é um controle de edição.
Os implementadores de rotinas DDX ou DDV personalizadas devem chamar PrepareEditCtrl para todos os controles de edição para os quais estão trocando dados por meio de DDX ou validando dados por meio de DDV.
Para obter mais informações sobre como escrever suas próprias rotinas de DDX e DDV, consulte a Nota Técnica 26. Para obter uma visão geral da DDX e da DDV, consulte Troca e validação de dados da caixa de diálogo e Tópicos da caixa de diálogo.
CDataExchange::PrepareOleCtrl
A estrutura chama essa função membro para preparar o controle OLE especificado para DDX (troca de dados de caixa de diálogo) e DDV (validação).
COleControlSite* PrepareOleCtrl(int nIDC);
Parâmetros
nIDC
A ID do controle OLE a ser preparada para DDX ou DDV.
Valor de Devolução
Um ponteiro para o site do controle OLE.
Comentários
Use PrepareEditCtrl para editar controles ou PrepareCtrl para todos os outros controles que não sejam OLE.
Os implementadores de rotinas DDX ou DDV personalizadas devem chamar PrepareOleCtrl para todos os controles OLE para os quais estão trocando dados por meio de DDX ou validando dados por meio de DDV.
Para obter mais informações sobre como escrever suas próprias rotinas de DDX e DDV, consulte a Nota Técnica 26. Para obter uma visão geral da DDX e da DDV, consulte Troca e validação de dados da caixa de diálogo e Tópicos da caixa de diálogo.
Confira também
Exemplo de VIEWEX do MFC
Gráfico da hierarquia
CWnd::DoDataExchange
CWnd::UpdateData
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários