Classe CIPAddressCtrl
Fornece a funcionalidade do controle de endereço IP comum do Windows.
Sintaxe
class CIPAddressCtrl : public CWnd
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| CIPAddressCtrl::CIPAddressCtrl | Constrói um objeto CIPAddressCtrl. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CIPAddressCtrl::ClearAddress | Limpa o conteúdo do Controle de Endereço IP. |
| CIPAddressCtrl::Create | Cria um Controle de Endereço IP e o anexa a um objeto CIPAddressCtrl. |
| CIPAddressCtrl::CreateEx | Cria um controle de Endereço IP com os estilos estendidos do Windows especificados e o anexa a um objeto CIPAddressCtrl. |
| CIPAddressCtrl::GetAddress | Recupera os valores de endereço dos quatro campos no Controle de Endereço IP. |
| CIPAddressCtrl::IsBlank | Determina se todos os campos no Controle de Endereço IP estão vazios. |
| CIPAddressCtrl::SetAddress | Define os valores de endereço dos quatro campos no Controle de Endereço IP. |
| CIPAddressCtrl::SetFieldFocus | Define o foco do teclado como o campo especificado no Controle de Endereço IP. |
| CIPAddressCtrl::SetFieldRange | Define o intervalo no campo especificado no Controle de Endereço IP. |
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
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.
Chame o construtor, que cria o objeto
CIPAddressCtrl.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.
| Campo | Bits que contêm o valor do campo |
|---|---|
| 0 | 24 até 31 |
| 1 | 16 até 23 |
| 2 | 8 até 15 |
| 3 | 0 a 7 |
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.
| Campo | Bits que contêm o valor do campo |
|---|---|
| 0 | 24 até 31 |
| 1 | 16 até 23 |
| 2 | 8 até 15 |
| 3 | 0 a 7 |
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.