Partilhar via


Funções da troca de dados da caixa de diálogo para CRecordView e CDaoRecordView

Este tópico lista as funções DDX_Field usadas para trocar dados entre um CRecordset e um formulário CRecordView ou um CDaoRecordset e um formulário CDaoRecordView. O DAO é usado com bancos de dados do Access e tem suporte do Office 2013. O DAO 3.6 é a versão final e é considerado obsoleto.

Observação

Funções DDX_Field são como funções DDX na troca de dados com controles em um formulário. No entanto, ao contrário do DDX, elas trocam dados com os campos do objeto de conjunto de registros associado do modo de exibição em vez de com campos do próprio modo de exibição de registro. Para mais informações, confira classes CRecordView e CDaoRecordView.

Funções DDX_Field

Nome Descrição
DDX_FieldCBIndex Transfere dados inteiros entre um membro de dados do campo do conjunto de registros e o índice da seleção atual em uma caixa de combinação em um CRecordView ou CDaoRecordView.
DDX_FieldCBString Transfere dados CString entre um membro de dados do campo de conjunto de registros e o controle de edição de uma caixa de combinação em um CRecordView ou CDaoRecordView. Ao mover dados do conjunto de registros para o controle, essa função seleciona o item na caixa de combinação que começa com os caracteres na cadeia de caracteres especificada.
DDX_FieldCBStringExact Transfere dados CString entre um membro de dados do campo de conjunto de registros e o controle de edição de uma caixa de combinação em um CRecordView ou CDaoRecordView. Ao mover dados do conjunto de registros para o controle, essa função seleciona o item na caixa de combinação que corresponde exatamente à cadeia de caracteres especificada.
DDX_FieldCheck Transfere dados boolianos entre um membro de dados do campo de conjunto de registros e uma caixa de seleção em um CRecordView ou CDaoRecordView.
DDX_FieldLBIndex Transfere dados inteiros entre um membro de dados do campo do conjunto de registros e o índice da seleção atual em uma caixa de listagem em um CRecordView ou CDaoRecordView.
DDX_FieldLBString Gerencia a transferência de dados CString entre um controle de caixa de listagem e os membros de dados de campo de um conjunto de registros. Ao mover dados do conjunto de registros para o controle, essa função seleciona o item na caixa de listagem que começa com os caracteres na cadeia de caracteres especificada.
DDX_FieldLBStringExact Gerencia a transferência de dados CString entre um controle de caixa de listagem e os membros de dados de campo de um conjunto de registros. Ao mover dados do conjunto de registros para o controle, essa função seleciona o primeiro item que corresponde exatamente à cadeia de caracteres especificada.
DDX_FieldRadio Transfere dados inteiros entre um membro de dados de campo de conjunto de registros e um grupo de botões de opção em um CRecordView ou CDaoRecordView.
DDX_FieldScroll Define ou obtém a posição de rolagem de um controle de barra de rolagem em um CRecordView ou CDaoRecordView. Chame de sua função DoFieldExchange.
DDX_FieldSlider Sincroniza a posição do polegar de um controle deslizante em uma exibição de registro e um membro de dados de campo int de um conjunto de registros.
DDX_FieldText Versões sobrecarregadas estão disponíveis para transferir dados int, UINT, long, DWORD, CString, float, double, short, COleDateTime e COleCurrency entre um membro de dados de campo de conjunto de registros e uma caixa de edição em um CRecordView ou CDaoRecordView.

DDX_FieldCBIndex

A função DDX_FieldCBIndex sincroniza o índice do item selecionado no controle de caixa de listagem de um controle de caixa de combinação em um modo de exibição de registro e um membro de dados de campo int de um conjunto de registros associado à exibição de registro.

void AFXAPI DDX_FieldCBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldCBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID de um controle no objeto CRecordView ou CDaoRecordView.

index
Uma referência a um membro de dados de campo no objeto CRecordset ou CDaoRecordset associado.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados.

Comentários

Ao mover dados do conjunto de registros para o controle, essa função define a seleção no controle com base no valor especificado no índice. Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for nulo, o MFC definirá o valor do índice como 0. Em uma transferência do controle para o conjunto de registros, se o controle estiver vazio ou se nenhum item estiver selecionado, o campo do conjunto de registros será definido como 0.

Use a primeira versão se você estiver trabalhando com as classes baseadas em ODBC. Use a segunda versão se você estiver trabalhando com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre os campos DDX para CRecordView e CDaoRecordView, confira o artigo Exibições de Registro.

Exemplo

Confira DDX_FieldText para um exemplo geral de DDX_Field. O exemplo seria semelhante para DDX_FieldCBIndex.

Requisitos

Cabeçalho: afxdao.h

DDX_FieldCBString

A função DDX_FieldCBString gerencia a transferência de dados CString entre o controle de edição de um controle de caixa de combinação em uma exibição de registro e um membro de dados de campo CString de um conjunto de registros associado à exibição de registro.

void AFXAPI DDX_FieldCBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldCBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID de um controle no objeto CRecordView ou CDaoRecordView.

value
Uma referência a um membro de dados de campo no objeto CRecordset ou CDaoRecordset associado.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados.

Comentários

Ao mover dados do conjunto de registros para o controle, essa função define a seleção atual na caixa de combinação para a primeira linha que começa com os caracteres na cadeia de caracteres especificada em valor. Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for nulo, qualquer seleção será removida da caixa de combinação e o controle de edição da caixa de combinação será definido como vazio. Em uma transferência do controle para o conjunto de registros, se o controle estiver vazio, o campo do conjunto de registros será definido como Null se o campo permitir.

Use a primeira versão se você estiver trabalhando com as classes baseadas em ODBC. Use a segunda versão se você estiver trabalhando com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre os campos DDX para CRecordView e CDaoRecordView, confira o artigo Exibições de Registro.

Exemplo

Confira DDX_FieldText para um exemplo geral de DDX_Field. O exemplo inclui uma chamada para DDX_FieldCBString.

Requisitos

Cabeçalho afxdao.h

DDX_FieldCBStringExact

A função DDX_FieldCBStringExact gerencia a transferência de dados CString entre o controle de edição de um controle de caixa de combinação em uma exibição de registro e um membro de dados de campo CString de um conjunto de registros associado à exibição de registro.

void AFXAPI DDX_FieldCBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldCBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID de um controle no objeto CRecordView ou CDaoRecordView.

value
Uma referência a um membro de dados de campo no objeto CRecordset ou CDaoRecordset associado.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados.

Comentários

Ao mover dados do conjunto de registros para o controle, essa função define a seleção atual na caixa de combinação para a primeira linha que corresponde exatamente à cadeia de caracteres especificada em valor. Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for NULL, qualquer seleção será removida da caixa de combinação e a caixa de edição da caixa de combinação será definida como vazia. Em uma transferência do controle para o conjunto de registros, se o controle estiver vazio, o campo do conjunto de registros será definido como NULL.

Use a primeira versão se você estiver trabalhando com as classes baseadas em ODBC. Use a segunda versão se você estiver trabalhando com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre os campos DDX para CRecordView e CDaoRecordView, confira o artigo Exibições de Registro.

Exemplo

Confira DDX_FieldText para um exemplo geral de DDX_Field. As chamadas para DDX_FieldCBStringExact seriam semelhantes.

Requisitos

Cabeçalho afxdao.h

DDX_FieldCheck

A função DDX_FieldCheck gerencia a transferência de dados int entre um controle de caixa de seleção em uma caixa de diálogo, exibição de formulário ou objeto de exibição de controle e um membro de dados int da caixa de diálogo, exibição de formulário ou objeto de exibição de controle.

void AFXAPI DDX_FieldCheck(
    CDataExchange* pDX,
    int nIDC,
    int& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldCheck(
    CDataExchange* pDX,
    int nIDC,
    int& value,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID do recurso do controle da caixa de seleção associado à propriedade de controle.

value
Uma referência a uma variável membro da caixa de diálogo, exibição de formulário ou objeto de exibição de controle com a qual os dados são trocados.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados.

Comentários

Quando DDX_FieldCheck é chamado, o valor é definido como o estado atual do controle da caixa de seleção ou o estado do controle é definido como valor, dependendo da direção da transferência.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo.

Requisitos

Cabeçalho afxdao.h

DDX_FieldLBIndex

A função DDX_FieldLBIndex sincroniza o índice do item selecionado em um controle de caixa de listagem em uma exibição de registro e um membro de dados de campo int de um conjunto de registros associado à exibição de registro.

void AFXAPI DDX_FieldLBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldLBIndex(
    CDataExchange* pDX,
    int nIDC,
    int& index,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID de um controle no objeto CRecordView ou CDaoRecordView.

index
Uma referência a um membro de dados de campo no objeto CRecordset ou CDaoRecordset associado.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados.

Comentários

Ao mover dados do conjunto de registros para o controle, essa função define a seleção no controle com base no valor especificado no índice. Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for nulo, o MFC definirá o valor do índice como 0. Em uma transferência do controle para o conjunto de registros, se o controle estiver vazio, o campo do conjunto de registros será definido como 0.

Use a primeira versão se você estiver trabalhando com as classes baseadas em ODBC. Use a segunda versão se você estiver trabalhando com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre os campos DDX para CRecordView e CDaoRecordView, confira o artigo Exibições de Registro.

Exemplo

Confira DDX_FieldText para um exemplo geral de DDX_Field.

Requisitos

Cabeçalho afxdao.h

DDX_FieldLBString

A DDX_FieldLBString copia a seleção atual de um controle de caixa de listagem em uma exibição de registro para um membro de dados de campo CString de um conjunto de registros associado ao modo de exibição de registro.

void AFXAPI DDX_FieldLBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldLBString(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID de um controle no objeto CRecordView ou CDaoRecordView.

value
Uma referência a um membro de dados de campo no objeto CRecordset ou CDaoRecordset associado.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados.

Comentários

Na direção inversa, essa função define a seleção atual na caixa de listagem para a primeira linha que começa com os caracteres na cadeia de caracteres especificada pelo valor. Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for nulo, qualquer seleção será removida da caixa de listagem. Em uma transferência do controle para o conjunto de registros, se o controle estiver vazio, o campo do conjunto de registros será definido como Null.

Use a primeira versão se você estiver trabalhando com as classes baseadas em ODBC. Use a segunda versão se você estiver trabalhando com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre os campos DDX para CRecordView e CDaoRecordView, confira o artigo Exibições de Registro.

Exemplo

Confira DDX_FieldText para um exemplo geral de DDX_Field. As chamadas para DDX_FieldLBString seriam semelhantes.

Requisitos

Cabeçalho afxdao.h

DDX_FieldLBStringExact

A função DDX_FieldLBStringExact copia a seleção atual de um controle de caixa de listagem em uma exibição de registro para um membro de dados de campo CString de um conjunto de registros associado ao modo de exibição de registro.

void AFXAPI DDX_FieldLBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldLBStringExact(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID de um controle no objeto CRecordView ou CDaoRecordView.

value
Uma referência a um membro de dados de campo no objeto CRecordset ou CDaoRecordset associado.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados.

Comentários

Na direção inversa, essa função define a seleção atual na caixa de listagem como a primeira linha que corresponde exatamente à cadeia de caracteres especificada em valor. Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for nulo, qualquer seleção será removida da caixa de listagem. Em uma transferência do controle para o conjunto de registros, se o controle estiver vazio, o campo do conjunto de registros será definido como Null.

Use a primeira versão se você estiver trabalhando com as classes baseadas em ODBC. Use a segunda versão se você estiver trabalhando com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre os campos DDX para CRecordView e CDaoRecordView, confira o artigo Exibições de Registro.

Exemplo

Confira DDX_FieldText para um exemplo geral de DDX_Field. As chamadas para DDX_FieldLBStringExact seriam semelhantes.

Requisitos

Cabeçalho afxdao.h

DDX_FieldRadio

A função DDX_FieldRadio associa uma variável de membro int baseada em zero do conjunto de registros de uma exibição de registro ao botão de opção atualmente selecionado em um grupo de botões de opção no modo de exibição de registro.

void AFXAPI DDX_FieldRadio(
    CDataExchange* pDX,
    int nIDC,
    int& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldRadio(
    CDataExchange* pDX,
    int nIDC,
    int& value,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID do primeiro em um grupo (com estilo WS_GROUP) de controles de botão de opção adjacentes no objeto CRecordView ou CDaoRecordView.

value
Uma referência a um membro de dados de campo no objeto CRecordset ou CDaoRecordset associado.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados.

Comentários

Ao transferir do campo do conjunto de registros para o modo de exibição, essa função ativa o botão de opção radio (baseado em zero) e desativa os outros botões. Na direção inversa, essa função define o campo do conjunto de registros como o número ordinal do botão de opção que está ativado no momento (verificado). Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for nulo, nenhum botão será selecionado. Em uma transferência do controle para o conjunto de registros, se nenhum controle for selecionado, o campo do conjunto de registros será definido como Null se o campo permitir isso.

Use a primeira versão se você estiver trabalhando com as classes baseadas em ODBC. Use a segunda versão se você estiver trabalhando com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre os campos DDX para CRecordView e CDaoRecordView, confira o artigo Exibições de Registro.

Exemplo

Confira DDX_FieldText para um exemplo geral de DDX_Field. As chamadas para DDX_FieldRadio seriam semelhantes.

Requisitos

Cabeçalho afxdao.h

DDX_FieldScroll

A função DDX_FieldScroll sincroniza a posição de rolagem de um controle de barra de rolagem em uma exibição de registro e um membro de dados de campo int de um conjunto de registros associado à exibição de registro (ou com qualquer variável inteiro para a qual você escolher mapeá-lo).

void AFXAPI DDX_FieldScroll(
    CDataExchange* pDX,
    int nIDC,
    int& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldScroll(
    CDataExchange* pDX,
    int nIDC,
    int& value,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID do primeiro em um grupo (com estilo WS_GROUP) de controles de botão de opção adjacentes no objeto CRecordView ou CDaoRecordView.

value
Uma referência a um membro de dados de campo no objeto CRecordset ou CDaoRecordset associado.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados.

Comentários

Ao mover dados do conjunto de registros para o controle, essa função define a posição de rolagem do controle de barra de rolagem para o valor especificado em valor. Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for nulo, o controle da barra de rolagem será definido como 0. Em uma transferência do controle para o conjunto de registros, se o controle estiver vazio, o valor do campo do conjunto de registros será 0.

Use a primeira versão se você estiver trabalhando com as classes baseadas em ODBC. Use a segunda versão se você estiver trabalhando com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre os campos DDX para CRecordView e CDaoRecordView, confira o artigo Exibições de Registro.

Exemplo

Confira DDX_FieldText para um exemplo geral de DDX_Field. As chamadas para DDX_FieldScroll seriam semelhantes.

Requisitos

Cabeçalho afxdao.h

DDX_FieldSlider

A função DDX_FieldSlider sincroniza a posição de miniatura de um controle deslizante em uma exibição de registro e um membro de dados de campo int de um conjunto de registros associado à exibição de registro (ou com qualquer variável inteiro para a qual você escolher mapeá-lo).

Sintaxe

void AFXAPI DDX_FieldSlider(
    CDataExchange* pDX,
    int nIDC,
    int& value,
    CRecordset* pRecordset );

void AFXAPI DDX_FieldSlider(
   CDataExchange* pDX,
   int nIDC,
   int& value,
   CDaoRecordset* pRecordset );

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID do recurso do controle deslizante.

value
Uma referência ao valor a ser trocado. Esse parâmetro mantém ou será usado para definir a posição de miniatura atual do controle deslizante.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset associado ao qual os dados são trocados.

Comentários

Ao mover dados do conjunto de registros para o controle deslizante, essa função define a posição do controle deslizante para o valor especificado em valor. Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for nulo, a posição do controle deslizante será definida como 0. Em uma transferência do controle para o conjunto de registros, se o controle estiver vazio, o valor do campo do conjunto de registros será 0.

DDX_FieldSlider não troca informações de intervalo com controles deslizantes capazes de definir um intervalo em vez de simplesmente uma posição.

Use a primeira substituição da função se você estiver trabalhando com as classes baseadas em ODBC. Use a segunda substituição com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre o DDX para os campos CRecordView e CDaoRecordView, confira Exibições de Registro. Para informações sobre controles deslizantes, confira Como usar CSliderCtrl.

Exemplo

Confira DDX_FieldText para um exemplo geral de DDX_Field. As chamadas para DDX_FieldSlider seriam semelhantes.

Requisitos

Cabeçalho: afxdao.h

DDX_FieldText

A função DDX_FieldText gerencia a transferência de dados int, short, long, DWORD, CString, float, double, BOOL ou BYTE entre um controle de caixa de edição e os membros de dados de campo de um conjunto de registros.

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    BYTE& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    int& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    UINT& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    long& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    DWORD& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    float& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    double& value,
    CRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    short& value,
    CDaoRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    BOOL& value,
    CDaoRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    BYTE& value,
    CDaoRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    long& value,
    CDaoRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    DWORD& value,
    CDaoRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    CString& value,
    CDaoRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    float& value,
    CDaoRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    double& value,
    CDaoRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    COleDateTime& value,
    CDaoRecordset* pRecordset);

void AFXAPI DDX_FieldText(
    CDataExchange* pDX,
    int nIDC,
    COleCurrency& value,
    CDaoRecordset* pRecordset);

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange. A estrutura fornece esse objeto para estabelecer o contexto da troca de dados, incluindo sua direção.

nIDC
A ID de um controle no objeto CRecordView ou CDaoRecordView.

value
Uma referência a um membro de dados de campo no objeto CRecordset ou CDaoRecordset associado. O tipo de dados de valor depende de qual das versões sobrecarregadas de DDX_FieldText você usa.

pRecordset
Um ponteiro para o objeto CRecordset ou CDaoRecordset com o qual os dados são trocados. Esse ponteiro permite que DDX_FieldText detecte e defina valores nulos.

Comentários

Para objetos CDaoRecordset, DDX_FieldText também gerencia a transferência de valores COleDateTime e COleCurrency. Um controle de caixa de edição vazio indica um valor nulo. Em uma transferência do conjunto de registros para o controle, se o campo do conjunto de registros for nulo, a caixa de edição será definida como vazia. Em uma transferência do controle para o conjunto de registros, se o controle estiver vazio, o campo do conjunto de registros será definido como Null.

Use as versões com parâmetros CRecordset se você estiver trabalhando com as classes baseadas em ODBC. Use as versões com parâmetros CDaoRecordset se você estiver trabalhando com as classes baseadas em DAO.

Para obter mais informações sobre a DDX, confira Validação e troca de dados de caixa de diálogo. Para exemplos e mais informações sobre os campos DDX para CRecordView e CDaoRecordView, confira o artigo Exibições de Registro.

Exemplo

A função DoDataExchange a seguir para um CRecordView contém chamadas de função DDX_FieldText para três tipos de dados: IDC_COURSELIST é uma caixa de combinação; os outros dois controles são caixas de edição. Para programação da DAO, o parâmetro m_pSet é um ponteiro para um CRecordset ou CDaoRecordset.

void CMyDaoRecordView::DoDataExchange(CDataExchange* pDX)
{
   CDaoRecordView::DoDataExchange(pDX);
   DDX_FieldCBString(pDX, IDC_LASTNAME, m_pSet->m_LastName, m_pSet);
   DDX_FieldText(pDX, IDC_ID, m_pSet->m_EmployeeID, m_pSet);
   DDX_FieldText(pDX, IDC_AGE, m_pSet->m_Age, m_pSet);
}

Requisitos

Cabeçalho afxdao.h

Confira também

Macros e Globais