繪製線條

本主題示範如何使用 GDI Plus 繪製線條。

若要在 Windows GDI+ 中繪製線條，您需要 Graphics 物件、 Pen 物件和 Color 物件。 Graphics物件提供DrawLine方法，而Pen物件會保存線條的屬性，例如色彩和寬度。 Pen物件的位址會當做引數傳遞至DrawLine方法。

下列程式會從 (0、0) 繪製線條到 (200、100) ，包含三個函式： WinMain、 WndProc和 OnPaint。 WinMain和WndProc函式提供大部分 Windows 應用程式通用的基本程式碼。 WndProc函式中沒有 GDI+ 程式碼。 WinMain函式有少量的 GDI+ 程式碼，也就是對 GdiplusStartup和GdiplusShutdown的必要呼叫。 實際建立 Graphics 物件的 GDI+ 程式碼，繪製線條位於 OnPaint 函式中。

OnPaint函式會接收裝置內容的控制碼，並將該控制碼傳遞至圖形建構函式。 傳遞至 Pen 建構函式的引數是 Color 物件的參考。 傳遞至色彩建構函式的四個數字代表色彩的 Alpha、紅色、綠色和藍色元件。 Alpha 元件決定色彩的透明度;0 完全透明，255 完全不透明。 傳遞至 DrawLine 方法的四個數字代表行的起點 (0、0) 和結束點 (200，100) 。

#include <stdafx.h>
#include <windows.h>
#include <objidl.h>
#include <gdiplus.h>
using namespace Gdiplus;
#pragma comment (lib,"Gdiplus.lib")

VOID OnPaint(HDC hdc)
{
   Graphics graphics(hdc);
   Pen      pen(Color(255, 0, 0, 255));
   graphics.DrawLine(&pen, 0, 0, 200, 100);
}

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);

INT WINAPI WinMain(HINSTANCE hInstance, HINSTANCE, PSTR, INT iCmdShow)
{
   HWND                hWnd;
   MSG                 msg;
   WNDCLASS            wndClass;
   GdiplusStartupInput gdiplusStartupInput;
   ULONG_PTR           gdiplusToken;
   
   // Initialize GDI+.
   GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, NULL);
   
   wndClass.style          = CS_HREDRAW | CS_VREDRAW;
   wndClass.lpfnWndProc    = WndProc;
   wndClass.cbClsExtra     = 0;
   wndClass.cbWndExtra     = 0;
   wndClass.hInstance      = hInstance;
   wndClass.hIcon          = LoadIcon(NULL, IDI_APPLICATION);
   wndClass.hCursor        = LoadCursor(NULL, IDC_ARROW);
   wndClass.hbrBackground  = (HBRUSH)GetStockObject(WHITE_BRUSH);
   wndClass.lpszMenuName   = NULL;
   wndClass.lpszClassName  = TEXT("GettingStarted");
   
   RegisterClass(&wndClass);
   
   hWnd = CreateWindow(
      TEXT("GettingStarted"),   // window class name
      TEXT("Getting Started"),  // window caption
      WS_OVERLAPPEDWINDOW,      // window style
      CW_USEDEFAULT,            // initial x position
      CW_USEDEFAULT,            // initial y position
      CW_USEDEFAULT,            // initial x size
      CW_USEDEFAULT,            // initial y size
      NULL,                     // parent window handle
      NULL,                     // window menu handle
      hInstance,                // program instance handle
      NULL);                    // creation parameters
      
   ShowWindow(hWnd, iCmdShow);
   UpdateWindow(hWnd);
   
   while(GetMessage(&msg, NULL, 0, 0))
   {
      TranslateMessage(&msg);
      DispatchMessage(&msg);
   }
   
   GdiplusShutdown(gdiplusToken);
   return msg.wParam;
}  // WinMain

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, 
   WPARAM wParam, LPARAM lParam)
{
   HDC          hdc;
   PAINTSTRUCT  ps;
   
   switch(message)
   {
   case WM_PAINT:
      hdc = BeginPaint(hWnd, &ps);
      OnPaint(hdc);
      EndPaint(hWnd, &ps);
      return 0;
   case WM_DESTROY:
      PostQuitMessage(0);
      return 0;
   default:
      return DefWindowProc(hWnd, message, wParam, lParam);
   }
} // WndProc

請注意WinMain函式中GdiplusStartup的呼叫。 GdiplusStartup函式的第一個參數是ULONG_PTR的位址。 GdiplusStartup 會將稍後傳遞至 GdiplusShutdown 函式的權杖填滿該變數。 GdiplusStartup函式的第二個參數是GdiplusStartupInput結構的位址。 上述程式碼依賴預設 GdiplusStartupInput 建構函式來適當地設定結構成員。