Класс CIPAddressCtrl
Предоставляет функциональные возможности стандартного элемента управления "IP-адрес" Windows.
Синтаксис
class CIPAddressCtrl : public CWnd
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
| CIPAddressCtrl::CIPAddressCtrl | Формирует объект CIPAddressCtrl. |
Открытые методы
| Имя | Описание |
|---|---|
| CIPAddressCtrl::ClearAddress | Очищает содержимое элемента управления IP-адресами. |
| CIPAddressCtrl::Create | Создает элемент управления IP-адресами и присоединяет его к объекту CIPAddressCtrl . |
| CIPAddressCtrl::CreateEx | Создает элемент управления IP-адреса с указанными расширенными стилями Windows и присоединяет его к объекту CIPAddressCtrl . |
| CIPAddressCtrl::GetAddress | Извлекает значения адресов для всех четырех полей в элементе управления IP-адресами. |
| CIPAddressCtrl::IsBlank | Определяет, пусты ли все поля в элементе управления IP-адресами. |
| CIPAddressCtrl::SetAddress | Задает значения адресов для всех четырех полей в элементе управления IP-адресами. |
| CIPAddressCtrl::SetFieldFocus | Задает фокус клавиатуры указанному полю в элементе управления IP-адресами. |
| CIPAddressCtrl::SetFieldRange | Задает диапазон в указанном поле в элементе управления IP-адресами. |
Замечания
Элемент управления IP-адреса, аналогичный элементу управления редактирования, позволяет вводить и управлять числовым адресом в формате IP-адреса.
Этот элемент управления (и, следовательно CIPAddressCtrl , класс) доступен только для программ, работающих в Microsoft Internet Explorer 4.0 и более поздних версий. Они также будут доступны в будущих версиях Windows и Windows NT.
Дополнительные сведения об элементе управления IP-адресами см. в разделе "Элементы управления IP-адресами" в пакете SDK для Windows.
Иерархия наследования
CIPAddressCtrl
Требования
Заголовок: afxcmn.h
CIPAddressCtrl::CIPAddressCtrl
Создает объект CIPAddressCtrl.
CIPAddressCtrl();
CIPAddressCtrl::ClearAddress
Очищает содержимое элемента управления IP-адресами.
void ClearAddress();
Замечания
Эта функция-член реализует поведение IPM_CLEARADDRESS сообщения Win32, как описано в пакете SDK для Windows.
CIPAddressCtrl::Create
Создает элемент управления IP-адресами и присоединяет его к объекту CIPAddressCtrl .
virtual BOOL Create(
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Параметры
dwStyle
Стиль элемента управления IP-адресов. Применение сочетания стилей окон. Необходимо включить стиль WS_CHILD, так как элемент управления должен быть дочерним окном. Список стилей Windows см. в статье CreateWindow в пакете SDK для Windows.
rect
Ссылка на размер и положение элемента управления IP-адресами. Это может быть объект CRect или структура RECT .
pParentWnd
Указатель на родительское окно элемента управления IP-адресами. Он не должен иметь значение NULL.
nID
Идентификатор элемента управления IP-адресов.
Возвращаемое значение
Ненулевое значение, если инициализация была успешной; в противном случае — 0.
Замечания
Вы создаете CIPAddressCtrl объект на двух шагах.
Вызовите конструктор, который создает
CIPAddressCtrlобъект.Вызов
Create, который создает элемент управления IP-адресами.
Если вы хотите использовать расширенные стили окон с элементом управления, вызовите CreateEx вместо Createэтого.
CIPAddressCtrl::CreateEx
Вызовите эту функцию, чтобы создать элемент управления (дочернее окно) и связать его с CIPAddressCtrl объектом.
virtual BOOL CreateEx(
DWORD dwExStyle,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID);
Параметры
dwExStyle
Задает расширенный стиль создаваемого элемента управления. Список расширенных стилей Windows см. в параметре dwExStyle для CreateWindowEx в пакете SDK для Windows.
dwStyle
Стиль элемента управления IP-адресов. Применение сочетания стилей окон. Необходимо включить стиль WS_CHILD, так как элемент управления должен быть дочерним окном. Список стилей Windows см. в статье CreateWindow в пакете SDK для Windows.
rect
Ссылка на структуру RECT , описывающую размер и положение создаваемого окна в координатах клиента pParentWnd.
pParentWnd
Указатель на окно, которое является родительским элементом элемента управления.
nID
Идентификатор дочернего окна элемента управления.
Возвращаемое значение
Имеет ненулевое значение в случае успешного выполнения, иначе — 0.
Замечания
Используйте CreateEx вместо создания расширенные стили Windows, указанные предисловием расширенного стиля Windows WS_EX_.
CIPAddressCtrl::GetAddress
Извлекает значения адресов для всех четырех полей в элементе управления IP-адресами.
int GetAddress(
BYTE& nField0,
BYTE& nField1,
BYTE& nField2,
BYTE& nField3);
int GetAddress(DWORD& dwAddress);
Параметры
nField0
Ссылка на значение поля 0 из упакованного IP-адреса.
nField1
Ссылка на поле 1 из упакованного IP-адреса.
nField2
Ссылка на значение поля 2 из упакованного IP-адреса.
nField3
Ссылка на поле 3 из упакованного IP-адреса.
dwAddress
Ссылка на адрес значения DWORD, получающего IP-адрес. См . примечания для таблицы, в которую показано заполнение dwAddress .
Возвращаемое значение
Число непустых полей в элементе управления IP-адресами.
Замечания
Эта функция-член реализует поведение сообщения Win32 IPM_GETADDRESS, как описано в пакете SDK для Windows. В первом прототипе выше числа в полях 0–3 элемента управления считываются слева направо соответственно, заполняют четыре параметра. Во втором прототипе выше dwAddress заполняется следующим образом.
| Поле | Биты, содержащие значение поля |
|---|---|
| 0 | 24–31 |
| 1 | 16–23 |
| 2 | От 8 до 15 |
| 3 | От 0 до 7 |
CIPAddressCtrl::IsBlank
Определяет, пусты ли все поля в элементе управления IP-адресами.
BOOL IsBlank() const;
Возвращаемое значение
Ненулевое значение, если все поля управления IP-адресами пусты; в противном случае — 0.
Замечания
Эта функция-член реализует поведение IPM_ISBLANK сообщения Win32, как описано в пакете SDK для Windows.
CIPAddressCtrl::SetAddress
Задает значения адресов для всех четырех полей в элементе управления IP-адресами.
void SetAddress(
BYTE nField0,
BYTE nField1,
BYTE nField2,
BYTE nField3);
void SetAddress(DWORD dwAddress);
Параметры
nField0
Значение поля 0 из упакованного IP-адреса.
nField1
Поле 1 из упакованного IP-адреса.
nField2
Значение поля 2 из упакованного IP-адреса.
nField3
Поле 3 из упакованного IP-адреса.
dwAddress
Значение DWORD, содержащее новый IP-адрес. См . примечания для таблицы, которая показывает, как заполнено значение DWORD.
Замечания
Эта функция-член реализует поведение сообщения Win32 IPM_SETADDRESS, как описано в пакете SDK для Windows. В первом прототипе выше числа в полях 0–3 элемента управления считываются слева направо соответственно, заполняют четыре параметра. Во втором прототипе выше dwAddress заполняется следующим образом.
| Поле | Биты, содержащие значение поля |
|---|---|
| 0 | 24–31 |
| 1 | 16–23 |
| 2 | От 8 до 15 |
| 3 | От 0 до 7 |
CIPAddressCtrl::SetFieldFocus
Задает фокус клавиатуры указанному полю в элементе управления IP-адресами.
void SetFieldFocus(WORD nField);
Параметры
nField
Отсчитываемый от нуля индекс поля, для которого необходимо задать фокус. Если это значение больше числа полей, фокус задается первым пустым полем. Если все поля не пусты, фокус устанавливается на первое поле.
Замечания
Эта функция-член реализует поведение сообщения Win32 IPM_SETFOCUS, как описано в пакете SDK для Windows.
CIPAddressCtrl::SetFieldRange
Задает диапазон в указанном поле в элементе управления IP-адресами.
void SetFieldRange(
int nField,
BYTE nLower,
BYTE nUpper);
Параметры
nField
Отсчитываемый от нуля индекс поля, к которому будет применен диапазон.
nLower
Ссылка на целое число, получающее нижнее ограничение указанного поля в этом элементе управления IP-адресов.
nUpper
Ссылка на целое число, получающее верхний предел указанного поля в этом элементе управления IP-адресов.
Замечания
Эта функция-член реализует поведение сообщения Win32 IPM_SETRANGE, как описано в пакете SDK для Windows. Используйте два параметра nLower и nUpper, чтобы указать нижние и верхние пределы поля вместо параметра wRange, используемого с сообщением Win32.