Заметки по WinAPI

  _In_  HWND hWnd,                // окно
  _In_  const RECT *lprcUpdate,    // какой прямоугольник надо преерисовать (игнорится. если задан регион)
  _In_  HRGN hrgnUpdate,            // какой регион надо перерисовать (если оба 0, то вся клиентская область)
  _In_  UINT flags                 // 

  - RDW_ERASE ( эффективен только с RDW_INVALIDATE ), посылает окну WM_ERASEBKGND (один из параметров - HDC, второй не используется) при этом сообщении DefWindowProc удаляет задний фон
      - сообщение WM_ERSAEBKGND
          - wParam - хэндл к DC
          - lParam - не используется 
          - означает что надо удалить BackGround
  - RDW_FRAME - заставляет всю неклиенсткую часть, которая пересекается с перерисовываемым регионом, перерисовываться (притом WM_NCPAINT(один параметр - хэндл региона) шлется и DefWindowProc перерисовывает неклиентскую часть в области)
  - RDW_INTERNALPAINT - шлет окну WM_PAINT вне зависимости от региона и прямоугольника
  - RDW_INVALIDATE - делает невалидными область или прямоугольник или окно
  - RDW_NO{one of the messages above} - убирает все сообщения, которые были посланы теми флагами
  - RDW_ERASENOW, RDW_UPDATENOW - эта же функция и перерисовывает окно (а не просто помещает сообщения в очереди)
  - RDW_ALL(NO)CHILDREN - (не) применяет операции к дочерним окнам в зоне действия (по дефолту зависит от WS_CLIPCHILDREN)

• заполняет структура PANITSTRUCT и возвращает HDC (хэндл к display device context) typedef struct tagPAINTSTRUCT {

    HDC  hdc;        // dc экрана
    BOOL fErase;    // надо ли удалять background
    RECT rcPaint;    // прямоугольник, в котором можно рисовать
    BOOL fRestore;    // этот и далее - reserved
    BOOL fIncUpdate;
    BYTE rgbReserved[32];
  

  } PAINTSTRUCT, *PPAINTSTRUCT;

• обозначает, что окну надо отрисовать свою клиентскую область в определенном DC
• wParam - Handle to DC
• lParam - options
  • PRF_CHECKVISIBLE - отрисуй только если окно видимо
  • PRF_CHILDREN - отрисую видимых детей
  • PRF_CLIENT - отрисуй клиентскую область
  • PRF_ERASEBKGND - удали задний фон перед отрисовкой
  • PRF_NONCLIENT - отрисуй неклиентскую часть
  • PRF_OWNED - отрисуй все owned окна

• BitMap
• Brush
• Font
• Pen
• Region

• возвращает предыдущий объект

• class
  • не использовать, существуют лишь для обратной совместимости с 16-битной версией
• common
  • хранятся в специальном кеше системы, используются в приложениях с нечастой перерисовкой. Они заняты дефолтноыми данными, и приложение, после release все изменеия затираются. в связи со способом хранения, сильно огрнаничены в количестве
• private
  • после release изменения сохраняются, и такой DC живет, пока существует хоть одно окно, которое ползуется этим DC. Создается при регистрации класса окна с флагом CS_OWNDC. Достается функциями GetDC, GetDCEx и BeginPaint
• window
  • позволяют рисовать где угодно в окне (включая неклиентскую область), используются когад обрабатываются сообщения типа WM_NCPAINT WM_NCACTIVATE. Использовать не рекомендуется. Добывается функцией HDC ::GetWindowDC( HWND )
• parent
  • используется системой для более быстрого определения, где перерирсовывать родителя, а где - ребенка

• используется для печати на принтеры (ВАШ КЭП!), создается приомощи функции CreateDC HDC CreateDC(

    LPCTSTR lpszDriver,                // драйвер (в принтере обычно NULL)
    _In_  LPCTSTR lpszDevice,        // device (для принетра - как называется в панели управления принтерами)
    LPCTSTR lpszOutput,                // для обратной совместимости
    _In_  const DEVMODE *lpInitData    // дополнительная инициализация (если требуется)
  

  );

• вместо того, чтобы все время отсылать команды устройству, можно все рисовать в памяти, на вирутальном девайсе. Для этого есть функция CreateCompatibleDC, потом задается BitMap'а (ерез SelectObject). Потом (после всех рисований), при помощи BitBlt можно скопировать ее на экран (вот и двойная буферизация)

• используются для вытаскивания дефолтных параметров девайса
• CreateIC создает его, далее через GetCurrentOjbect и GetObject можно получить объекты

• спрсоить у препа

• регион это прямоугольныя, полтгональная или круглая область (или объединения таковых), которая может быть заполнена,нарисована, отображена, и на ней отдельно можно обрабатывать всякие клики мышкой
• создание
  • CreateRectRgn(Indirect) // создать прямоугольный регион из 4-х координат (или из RECT)
  • CreateRoundRectRgn - чеыре координаты прямоугольника и параметры эллипса для закругления
  • CreateEllipticRgn(Indirect) - четыре координаты (RECT)- прямоугольник, в который будет вписан эллипс эллипс
  • CreatePolygonRgn( POINT*, INT cPoints, INT fnPolyFillMode ) -массив точек, длина массива и тип заполнения
    • ALTERNATE - заполняет область между нечетно и четно нумерованными сторонами полигона каждой горизонтали (внутри)
    • WINDING - полностью заливает регион
• сравнение BOOL EqualRgn( HRGN1, HRGN2 )
• наполнение BOOL FillRgn( HDC, HRGN, HBRUSH )
• объединение int CombineRgn( HRGN dest, HRGN1, HRGN2, RGN_AND|COPY|DIFF|OR|XOR )
  • возвращаемое значение NULLREGION, SIMPLEREGION, COMPLEXREGION, ERROR
• отрисовка PaintRgn( HDC, HRGN )
• инвертирование цветов InvertRgn( HDC, HRGN )
• отрисовка границ региона FrameRgn( HDC, HRGN, HBRUSH, nWidth, nHeight )
• также регионы можно сдвигать, получать содержащий их прямоугольник и проверять, лежит ли в не мтчока(GetRgnBox, OffsetRgn, PtInRegion )

• world
• page
• device
• physical device