Visual C++. Описание стандартных классов - Create

ОГЛАВЛЕНИЕ


Create

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

Возвращаемое значение

TRUE, если был создан объект класса CProgressCtrl, в противном случае - FALSE.

Аргументы

  • dwStyle - определяет стиль линейного индикатора. Окно линейного индикатора всегда создается как дочернее окно, родительским окном которого, обычно, является диалоговое окно. Данный аргумент может представлять собой любую допустимую комбинацию стандартных стилей окна, однако все стили, кроме перечисленных ниже будут игнорироваться:
    WS_BORDER - создает рамку вокруг окна;
    WS_CHILD - создает дочернее окно (обязательный стиль для объекта класса CProgressCtrl);
    WS_CLIPCHILDREN - исключает области, занимаемые дочерними окнами из области перерисовки родительского окна. Задается при создании объекта класса родительского окна;
    WS_CLIPSIBLINGS - исключает области, занимаемые другими дочерними окнами из области перерисовки данного дочернего окна;
    WS_DISABLED - создает неактивное окно;
    WS_VISIBLE - создает окно, которое сразу же отображается на экране;
    WS_TABSTOP - включает данное окно в последовательность окон, по которой можно перемещаться путем нажатия клавиши TAB. Кроме данных стилей, линейный индикатор использует два дополнительных стиля:
    PBS_VERTICAL - ориентирует полосу линейного индикатора в вертикальном направлении и ее заполнение производится сверху вниз. Если этот флаг не установлен, полоса линейного индикатора располагается в горизонтальном направлении и ее заполнение производится слева направо;
    PBS_SMOOTH - отображает сплошную полосу линейного индикатора. По умолчанию полоса линейного индикатора разделена на блоки.
  • rect - определяет размер и положение линейного индикатора. Этот аргумент может представлять собой объект класса CRect или объект структуры RECT. Поскольку данный элемент управления представляет собой дочернее окно, определяемые в данном аргументе координаты являются относительными и определяются системой координат, установленных в родительском окне.
  • pParentWnd - указатель на объект класса родительского окна, обычно это объект класса CDialog. Данный аргумент не может иметь нулевого значения.
  • nID - идентификатор ресурса линейного индикатора.

Описание

Создание объекта класса CProgressCtrl состоит из двух этапов: на первом этапе вызывается конструктор, создающий объект класса CProgressCtrl, а на втором этапе вызывается функция Create, создающая связанное с ним окно.