CDC::BeginPath

아티클
06/10/2015

장치 컨텍스트에서 경로 대괄호를 엽니다.

BOOL BeginPath();

반환 값

함수가 성공 하면 0이 아닌. 그렇지 않으면 0입니다.

설명

경로 대괄호로 시작 되 면 응용 프로그램 경로에 놓인 점을 정의 하는 그리기 기능 GDI 호출을 시작할 수 있습니다. 응용 프로그램 호출 하 여 열린 패스 괄호를 닫을 수 있습니다는 EndPath 멤버 함수입니다. 응용 프로그램이 호출 하는 경우 BeginPath, 이전 모든 경로 삭제 됩니다.

참조 BeginPath 에 있는 Windows SDK 패스에서 점을 정의 드로잉 함수에 대 한.

예제

// This implementation uses GDI paths to draw the outline of 
// some text in a TrueType font. The path is used to record the way 
// the TrueType font would be drawn. Then, the function uses the data 
// returned from CDC::GetPath() to draw the font--without filling it. 
void CDCView::DrawPath(CDC* pDC)
{
   // Describe a 24-point truetype font of normal weight
   LOGFONT lf;
   memset(&lf, 0, sizeof(lf));
   lf.lfHeight = -MulDiv(24, pDC->GetDeviceCaps(LOGPIXELSY), 72);
   lf.lfWeight = FW_NORMAL;
   lf.lfOutPrecision = OUT_TT_ONLY_PRECIS;

   // create and select it
   CFont newFont;
   if (!newFont.CreateFontIndirect(&lf))
      return;
   CFont* pOldFont = pDC->SelectObject(&newFont);

   // use a path to record how the text was drawn
   pDC->BeginPath();
   pDC->TextOut(10, 10, _T("Outline this!"));
   pDC->EndPath();

   // Find out how many points are in the path. Note that 
   // for long strings or complex fonts, this number might be 
   // gigantic! 
   int nNumPts = pDC->GetPath(NULL, NULL, 0);
   if (nNumPts == 0)
      return;

   // Allocate memory to hold points and stroke types from 
   // the path.
   LPPOINT lpPoints = NULL;
   LPBYTE lpTypes = NULL;
   try
   {
      lpPoints = new POINT[nNumPts];
      lpTypes = new BYTE[nNumPts];
   }
   catch (CException* pe)
   {
      delete [] lpPoints;
      lpPoints = NULL;
      delete [] lpTypes;
      lpTypes = NULL;
      pe->Delete();  
   }
   if (lpPoints == NULL || lpTypes == NULL)
      return;

   // Now that we have the memory, really get the path data.
   nNumPts = pDC->GetPath(lpPoints, lpTypes, nNumPts);

   // If it worked, draw the lines. Windows 98 doesn't support 
   // the PolyDraw API, so we use our own member function to do 
   // similar work. If you're targeting only later versions of  
   // Windows, you can use the PolyDraw() API and avoid the  
   // COutlineView::PolyDraw() member function. 

   if (nNumPts != -1)
      pDC->PolyDraw(lpPoints, lpTypes, nNumPts);

   // Release the memory we used 
   delete [] lpPoints;
   delete [] lpTypes;

   // Put back the old font
   pDC->SelectObject(pOldFont);

   return;
}