Partilhar via

Rotinas de validação dos dados da caixa de diálogo padrão

  • Artigo

Este tópico lista as rotinas de DDV (validação de dados de diálogo padrão) usadas para controles de diálogo MFC comuns.

Observação

As rotinas de troca de dados de caixa de diálogo padrão são definidas no arquivo de cabeçalho afxdd_.h. No entanto, os aplicativos devem incluir afxwin.h.

Funções DDV

Nome Descrição
DDV_MaxChars Verifica se o número de caracteres em um dado valor de controle não excede um máximo determinado.
DDV_MinMaxByte Verifica se um determinado valor de controle não excede um dado intervalo de BYTE.
DDV_MinMaxDateTime Verifica se um determinado valor de controle não excede um dado intervalo de tempo.
DDV_MinMaxDouble Verifica se um determinado valor de controle não excede um dado intervalo double.
DDV_MinMaxDWord Verifica se um determinado valor de controle não excede um determinado intervalo DWORD.
DDV_MinMaxFloat Verifica se um determinado valor de controle não excede um dado intervalo float.
DDV_MinMaxInt Verifica se um determinado valor de controle não excede um dado intervalo int.
DDV_MinMaxLong Verifica se um determinado valor de controle não excede um dado intervalo long.
DDV_MinMaxLongLong Verifica se um determinado valor de controle não excede um determinado intervalo LONGLONG.
DDV_MinMaxMonth Verifica se um determinado valor de controle não excede um determinado intervalo de datas.
DDV_MinMaxShort Verifica se um determinado valor de controle não excede um dado intervalo short.
DDV_MinMaxSlider Verifica se um determinado valor de controle deslizante está dentro do intervalo determinado.
DDV_MinMaxUInt Verifica se um determinado valor de controle não excede um determinado intervalo UINT.
DDV_MinMaxUnsigned Verifica se um determinado valor de controle está entre dois valores especificados.
DDV_MinMaxULongLong Verifica se um determinado valor de controle não excede um determinado intervalo ULONGLONG.

DDV_MaxChars

Chame DDV_MaxChars para verificar se a quantidade de caracteres no controle associado a value não excede nChars.

void AFXAPI DDV_MaxChars(
    CDataExchange* pDX,
    CString const& value,
    int nChars);

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.

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

nChars
Número máximo de caracteres permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxByte

Chame DDV_MinMaxByte para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxByte(
    CDataExchange* pDX,
    BYTE value,
    BYTE minVal,
    BYTE maxVal);

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.

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

minVal
Valor mínimo (do tipo BYTE) permitido.

maxVal
Valor máximo (do tipo BYTE) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxDateTime

Chame DDV_MinMaxDateTime para verificar se o valor de data/hora no controle de seletor de data e hora (CDateTimeCtrl) associado ao refValue está entre refMinRange e refMaxRange.

void AFXAPI DDV_MinMaxDateTime(
    CDataExchange* pDX,
    CTime& refValue,
    const CTime* refMinRange,
    const CTime* refMaxRange);

void AFXAPI DDV_MinMaxDateTime(
    CDataExchange* pDX,
    COleDateTime& refValue,
    const COleDateTime* refMinRange,
    const COleDateTime* refMaxRange);

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. Você não precisa excluir esse objeto.

refValue
Uma referência a um objeto CTime ou COleDateTime associado a uma variável membro da caixa de diálogo, exibição de formulário ou objeto de exibição de controle. Esse objeto contém os dados a serem validados.

refMinRange
Valor mínimo de data/hora permitido.

refMaxRange
Valor máximo de data/hora permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxDouble

Chame DDV_MinMaxDouble para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxDouble(
    CDataExchange* pDX,
    double const& value,
    double minVal,
    double maxVal);

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.

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

minVal
Valor mínimo (do tipo double) permitido.

maxVal
Valor máximo (do tipo double) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxDWord

Chame DDV_MinMaxDWord para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxDWord(
    CDataExchange* pDX,
    DWORD const& value,
    DWORD minVal,
    DWORD maxVal);

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.

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

minVal
Valor mínimo (do tipo DWORD) permitido.

maxVal
Valor máximo (do tipo DWORD) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxFloat

Chame DDV_MinMaxFloat para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxFloat(
    CDataExchange* pDX,
    float value,
    float minVal,
    float maxVal);

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.

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

minVal
Valor mínimo (do tipo float) permitido.

maxVal
Valor máximo (do tipo float) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxInt

Chame DDV_MinMaxInt para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxInt(
    CDataExchange* pDX,
    int value,
    int minVal,
    int maxVal);

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.

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

minVal
Valor mínimo (do tipo int) permitido.

maxVal
Valor máximo (do tipo int) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxLong

Chame DDV_MinMaxLong para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxLong(
    CDataExchange* pDX,
    long value,
    long minVal,
    long maxVal);

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.

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

minVal
Valor mínimo (do tipo long) permitido.

maxVal
Valor máximo (do tipo long) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxLongLong

Chame DDV_MinMaxLongLong para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxLongLong(
    CDataExchange* pDX,
    LONGLONG value,
    LONGLONG minVal,
    LONGLONG maxVal);

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.

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

minVal
Valor mínimo (do tipo LONGLONG) permitido.

maxVal
Valor máximo (do tipo LONGLONG) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxMonth

Chame DDV_MinMaxMonth para verificar se o valor de hora/data no controle de calendário de mês (CMonthCalCtrl) associado ao refValue está entre refMinRange e refMaxRange.

void AFXAPI DDV_MinMaxMonth(
    CDataExchange* pDX,
    CTime& refValue,
    const CTime* refMinRange,
    const CTime* refMaxRange);

void AFXAPI DDV_MinMaxMonth(
    CDataExchange* pDX,
    COleDateTime& refValue,
    const COleDateTime* refMinRange,
    const COleDateTime* refMaxRange);

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.

refValue
Uma referência a um objeto do tipo CTime ou COleDateTime associado a uma variável de membro da caixa de diálogo, exibição de formulário ou objeto de exibição de controle. Esse objeto contém os dados a serem validados. O MFC passa essa referência quando DDV_MinMaxMonth é chamado.

refMinRange
Valor mínimo de data/hora permitido.

refMaxRange
Valor máximo de data/hora permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxShort

Chame DDV_MinMaxShort para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxShort(
    CDataExchange* pDX,
    short value,
    short minVal,
    short maxVal);

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.

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

minVal
Valor mínimo (do tipo short) permitido.

maxVal
Valor máximo (do tipo short) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxSlider

Chame DDV_MinMaxSlider para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxSlider(
    CDataExchange* pDX,
    DWORD value,
    DWORD minVal,
    DWORD maxVal);

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.

value
Uma referência ao valor a ser validado. Esse parâmetro contém ou define a posição da miniatura atual do controle deslizante.

minVal
Valor mínimo permitido.

maxVal
Valor máximo permitido.

Comentários

Para mais informações sobre DDV, confira Validação e troca de dados de caixa de diálogo. Para informações sobre controles deslizantes, confira Como usar CSliderCtrl.

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxUInt

Chame DDV_MinMaxUInt para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxUInt(
    CDataExchange* pDX,
    UINT value,
    UINT minVal,
    UINT maxVal);

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.

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

minVal
Valor mínimo (do tipo UINT) permitido.

maxVal
Valor máximo (do tipo UINT) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxULongLong

Chame DDV_MinMaxULongLong para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

void AFXAPI DDV_MinMaxULongLong(
    CDataExchange* pDX,
    ULONGLONG value,
    ULONGLONG  minVal ,
    ULONGLONG  maxVal);

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.

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

minVal
Valor mínimo (do tipo ULONGLONG) permitido.

maxVal
Valor máximo (do tipo ULONGLONG) permitido.

Comentários

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

Requisitos

Cabeçalho afxdd_.h

DDV_MinMaxUnsigned

Chame DDV_MinMaxUnsigned para verificar se o valor no controle associado ao valor está entre minVal e maxVal.

Sintaxe

   void AFXAPI DDV_MinMaxUnsigned(
       CDataExchange* pDX,
       unsigned value,
       unsigned minVal,
       unsigned maxVal );

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.

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

minVal
Valor mínimo (do tipo unsigned) permitido.

maxVal
Valor máximo (do tipo unsigned) permitido.

Comentários

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

Requisitos

Cabeçalho: afxdd_.h

Confira também

Rotinas de troca dos dados da caixa de diálogo padrão
Macros e Globais
DDX_Slider
DDX_FieldSlider