Classe CIPAddressCtrl

Fornece a funcionalidade do controle de endereço IP comum do Windows.

Sintaxe

class CIPAddressCtrl : public CWnd

Membros

Construtores públicos

Métodos públicos

Comentários

Um controle de Endereço IP, semelhante a um controle de edição, permite que você insira e manipule um endereço numérico no formato IP (protocolo IP).

Esse controle (e, portanto, a classe CIPAddressCtrl) está disponível somente para programas em execução no Microsoft Internet Explorer 4.0 e posteriores. Eles também estarão disponíveis em versões futuras do Windows e do Windows NT.

Para obter mais informações gerais sobre o Controle de Endereço IP, consulte Controles de Endereço IP no SDK do Windows.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CIPAddressCtrl

Requisitos

Cabeçalho: afxcmn.h

CIPAddressCtrl::CIPAddressCtrl

Cria um objeto CIPAddressCtrl.

CIPAddressCtrl();

CIPAddressCtrl::ClearAddress

Limpa o conteúdo do Controle de Endereço IP.

void ClearAddress();

Comentários

Essa função membro implementa o comportamento da mensagem SB_GETTIPTEXT do Win32, conforme descrito no SDK do Windows.

CIPAddressCtrl::Create

Cria um Controle de Endereço IP e o anexa a um objeto CIPAddressCtrl.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parâmetros

dwStyle
O estilo do controle de Endereço IP. Aplique uma combinação de estilos de janela. Você precisa incluir o estilo WS_CHILD porque o controle precisa ser uma janela filho. Consulte CreateWindow no SDK do Windows para obter uma lista de estilos do Windows.

rect
Uma referência ao tamanho e à posição do Controle de Endereço IP. Pode ser um objeto CRect ou uma estrutura RECT.

pParentWnd
Um ponteiro para a janela pai do Controle de Endereço IP. Não pode ser NULL.

Nid
A ID do Controle de Endereço IP.

Valor de retorno

Um valor diferente de zero, se a inicialização tiver êxito. Caso contrário, 0.

Comentários

Um objeto CIPAddressCtrl é construído em duas etapas.

1. Chame o construtor, que cria o objeto CIPAddressCtrl.

2. Chame Create, que cria o Controle de Endereço IP.

Se você quiser usar estilos de janela estendidos com seu controle, chame CreateEx em vez de Create.

CIPAddressCtrl::CreateEx

Chame essa função para criar um controle (uma janela filho) e associá-lo ao objeto CIPAddressCtrl.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parâmetros

dwExStyle
Especifica o estilo estendido do controle que está sendo criado. Para obter uma lista de estilos estendidos do Windows, confira o parâmetro dwExStyle para CreateWindowEx no SDK do Windows.

dwStyle
O estilo do controle de Endereço IP. Aplique uma combinação de estilos de janela. Você precisa incluir o estilo WS_CHILD porque o controle precisa ser uma janela filho. Consulte CreateWindow no SDK do Windows para obter uma lista de estilos do Windows.

rect
Uma referência a uma estrutura RECT que descreve o tamanho e a posição da janela a ser criada, em coordenadas do cliente de pParentWnd.

pParentWnd
Um ponteiro para a janela que é pai do controle.

Nid
A ID da janela filho do controle.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

Use CreateEx em vez de Criar para aplicar estilos estendidos do Windows, especificados pelo prefácio WS_EX_ de estilos estendidos do Windows.

CIPAddressCtrl::GetAddress

Recupera os valores de endereço dos quatro campos no Controle de Endereço IP.

int GetAddress(
    BYTE& nField0,
    BYTE& nField1,
    BYTE& nField2,
    BYTE& nField3);

int GetAddress(DWORD& dwAddress);

Parâmetros

nField0
Uma referência ao valor do campo 0 de um endereço IP empacotado.

nField1
Uma referência ao valor do campo 1 de um endereço IP empacotado.

nField2
Uma referência ao valor do campo 2 de um endereço IP empacotado.

nField3
Uma referência ao valor do campo 3 de um endereço IP empacotado.

dwAddress
Uma referência ao endereço de um valor de DWORD que recebe o endereço IP. Consulte os Comentários para obter uma tabela que mostra como dwAddress é preenchido.

Valor de retorno

O número de campos que não estão em branco no Controle de Endereço IP.

Comentários

Essa função membro implementa o comportamento da mensagem IPM_GETADDRESS do Win32, conforme descrito no SDK do Windows. No primeiro protótipo acima, os números nos campos 0 a 3 do controle, lidos da esquerda para a direita, respectivamente, preenchem os quatro parâmetros. No segundo protótipo acima, dwAddress é preenchido da maneira descrita a seguir.

CIPAddressCtrl::IsBlank

Determina se todos os campos no Controle de Endereço IP estão vazios.

BOOL IsBlank() const;

Valor de retorno

Diferente de zero se todos os campos do Controle de Endereço IP estiverem vazios; caso contrário, 0.

Comentários

Essa função membro implementa o comportamento da mensagem Win32 IPM_ISBLANK, conforme descrito no SDK do Windows.

CIPAddressCtrl::SetAddress

Define os valores de endereço dos quatro campos no Controle de Endereço IP.

void SetAddress(
    BYTE nField0,
    BYTE nField1,
    BYTE nField2,
    BYTE nField3);

void SetAddress(DWORD dwAddress);

Parâmetros

nField0
O valor do campo 0 de um endereço IP empacotado.

nField1
O valor do campo 1 de um endereço IP empacotado.

nField2
O valor do campo 2 de um endereço IP empacotado.

nField3
O valor do campo 3 de um endereço IP empacotado.

dwAddress
Um valor de DWORD que contém o novo endereço IP. Consulte os Comentários para obter uma tabela que mostra como o valor de DWORD é preenchido.

Comentários

Essa função membro implementa o comportamento da mensagem IPM_SETADDRESS do Win32, conforme descrito no SDK do Windows. No primeiro protótipo acima, os números nos campos 0 a 3 do controle, lidos da esquerda para a direita, respectivamente, preenchem os quatro parâmetros. No segundo protótipo acima, dwAddress é preenchido da maneira descrita a seguir.

CIPAddressCtrl::SetFieldFocus

Define o foco do teclado como o campo especificado no Controle de Endereço IP.

void SetFieldFocus(WORD nField);

Parâmetros

nField
Índice do campo baseado em zero para o qual o foco deve ser definido. Se esse valor for maior que o número de campos, o foco será definido para o primeiro campo em branco. Se nenhum campo estiver em branco, o foco será definido para o primeiro campo.

Comentários

Essa função membro implementa o comportamento da mensagem IPM_SETFOCUS do Win32, conforme descrito no SDK do Windows.

CIPAddressCtrl::SetFieldRange

Define o intervalo no campo especificado no Controle de Endereço IP.

void SetFieldRange(
    int nField,
    BYTE nLower,
    BYTE nUpper);

Parâmetros

nField
Índice do campo baseado em zero ao qual o intervalo será aplicado.

nLower
Uma referência a um inteiro que recebe o limite inferior do campo especificado neste Controle de Endereço IP.

nUpper
Uma referência a um inteiro que recebe o limite superior do campo especificado neste Controle de Endereço IP.

Comentários

Essa função membro implementa o comportamento da mensagem Win32 IPM_SETRANGE, conforme descrito no SDK do Windows. Use os dois parâmetros, nLower e nUpper, para indicar os limites inferior e superior do campo, em vez do parâmetro wRange usado com a mensagem do Win32.

Confira também

Classe CWnd
Gráfico da hierarquia