Classe CIPAddressCtrl

Fornece a funcionalidade do controlo de endereços IP comuns do Windows.

Sintaxe

class CIPAddressCtrl : public CWnd

Membros

Construtores Públicos

Métodos Públicos

Observações

Um controlo de Endereço IP, um controlo semelhante a um controlo de edição, permite-lhe introduzir e manipular um endereço numérico em formato de Protocolo de Internet (IP).

Este controlo (e, portanto, a CIPAddressCtrl classe) está disponível apenas para programas a correr sob o Microsoft Internet Explorer 4.0 e versões posteriores. Também estarão disponíveis em futuras versões do Windows e Windows NT.

Para informações mais gerais sobre o Controlo de Endereços IP, consulte Controlos de Endereço IP no SDK do Windows.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CIPAddressCtrl

Requerimentos

Cabeçalho: afxcmn.h

CIPAddressCtrl::CIPAddressCtrl

Cria um CIPAddressCtrl objeto.

CIPAddressCtrl();

CIPAddressCtrl::ClearAddress

Limpa o conteúdo do Controlo de Endereços IP.

void ClearAddress();

Observações

Esta função membro implementa o comportamento da IPM_CLEARADDRESS de mensagens Win32, conforme descrito no SDK do Windows.

CIPAddressCtrl::Create

Cria um controlo de endereço IP e anexa-o a um CIPAddressCtrl objeto.

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

Parâmetros

dwStyle
O estilo do controlo do endereço IP. Aplique uma combinação de estilos de janelas. Deve incluir o estilo WS_CHILD porque o controlo deve ser uma janela filho. Consulte CreateWindow no SDK do Windows para uma lista de estilos de Windows.

retângulo
Uma referência ao tamanho e posição do Controlo de Endereços IP. Pode ser um objeto CRect ou uma estrutura RECT .

pParentWnd
Um apontador para a janela pai do Controlo de Endereços IP. Não pode ser NULL.

nID
O ID do Controlo de Endereços IP.

Valor de retorno

Não nula se a inicialização fosse bem-sucedida; caso contrário, 0.

Observações

Constroem um CIPAddressCtrl objeto em dois passos.

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

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

Se quiseres usar estilos de janelas estendidas com o teu controlo, chama CreateEx em vez de Create.

CIPAddressCtrl::CreateEx

Chama esta função para criar um controlo (uma janela filha) e associá-lo ao CIPAddressCtrl objeto.

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

Parâmetros

dwExStyle
Especifica o estilo estendido do controlo que está a ser criado. Para uma lista de estilos estendidos do Windows, consulte o parâmetro dwExStyle para CreateWindowEx no SDK do Windows.

dwStyle
O estilo do controlo do endereço IP. Aplique uma combinação de estilos de janelas. Deve incluir o estilo WS_CHILD porque o controlo deve ser uma janela filho. Consulte CreateWindow no SDK do Windows para uma lista de estilos de Windows.

retângulo
Uma referência a uma estrutura RECT que descreve o tamanho e a posição da janela a criar, em coordenadas cliente de pParentWnd.

pParentWnd
Um apontador para a janela que é o pai do controlo.

nID
O ID da janela criança do controlo.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

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

CIPAddressCtrl::GetAddress

Recupera os valores de endereço para os quatro campos no Controlo de Endereços 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 preenchido.

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

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

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

dwAddress
Uma referência ao endereço de um valor DWORD que recebe o endereço IP. Consulte Observações para uma tabela que mostra como o dwAddress é preenchido.

Valor de retorno

O número de campos não vazios no Controlo de Endereços IP.

Observações

Esta função membro implementa o comportamento da IPM_GETADDRESS de mensagens Win32, conforme descrito no SDK do Windows. No primeiro protótipo acima, os números nos campos 0 a 3 do controlo, lidos da esquerda para a direita respetivamente, preenchem os quatro parâmetros. No segundo protótipo acima, o dwAddress é preenchido da seguinte forma.

CIPAddressCtrl::IsBlank

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

BOOL IsBlank() const;

Valor de retorno

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

Observações

Esta função membro implementa o comportamento da IPM_ISBLANK de mensagens Win32, conforme descrito no SDK do Windows.

CIPAddressCtrl::SetAddress

Define os valores de endereço para os quatro campos no Controlo de Endereços 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 preenchido.

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

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

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

dwAddress
Um valor DWORD que contém o novo endereço IP. Consulte Observações para uma tabela que mostra como o valor DWORD é preenchido.

Observações

Esta função membro implementa o comportamento da IPM_SETADDRESS de mensagens Win32, conforme descrito no SDK do Windows. No primeiro protótipo acima, os números nos campos 0 a 3 do controlo, lidos da esquerda para a direita respetivamente, preenchem os quatro parâmetros. No segundo protótipo acima, o dwAddress é preenchido da seguinte forma.

CIPAddressCtrl::SetFieldFocus

Define o foco do teclado para o campo especificado no Controlo de Endereços IP.

void SetFieldFocus(WORD nField);

Parâmetros

nField
Índice de campo baseado em zero ao qual o foco deve ser definido. Se este valor for maior do que o número de campos, o foco é definido para o primeiro campo em branco. Se todos os campos não estiverem em branco, o foco é definido para o primeiro campo.

Observações

Esta função membro implementa o comportamento da IPM_SETFOCUS de mensagens Win32, conforme descrito no SDK do Windows.

CIPAddressCtrl::SetFieldRange

Define o intervalo no campo especificado no Controlo de Endereços IP.

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

Parâmetros

nField
Índice de 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 Controlo de Endereço IP.

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

Observações

Esta 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 Win32.

Consulte também

Classe CWnd
Gráfico de Hierarquia