共用方式為


CDC::StartDoc

告知裝置驅動程式新列印工作開始,而且應該多工緩衝處理所有後續 StartPageEndPage 呼叫相同工作之下,直到 EndDoc 呼叫時發生。

int StartDoc( 
   LPDOCINFO lpDocInfo  
); 
int StartDoc( 
   LPCTSTR lpszDocName  
);

參數

  • lpDocInfo
    包含文件的名稱和輸出檔的名稱 DOCINFO 結構的點。

  • lpszDocName
    out 包含檔案名稱的字串。

傳回值

如果函式成功,則傳回值大於零。 這個值是文件的列印工作識別項。

如果函式失敗,則傳回值小於或等於零。

備註

這可確保資料超過一頁的長度不會穿插在其他工作。

在 Windows 3.1 (含) 以後版本,這個函式會取代 STARTDOC 印表機逸出。 使用這個函式可確保包含多個頁面的文件不含穿插在其他列印工作。

不應該使用StartDoc 於中繼資料內。

範例

這個程式碼片段中取得預設的印表機,開啟,然後列印工作正在多工緩衝處理網頁具有「Hello, World!」套用至這個。 由於這個程式碼會列印的文字不會縮放至印表機的邏輯單位,輸出文字可能是以這種方式小寫字母結果無法讀取。 CDC 縮放功能,例如 SetMapModeSetViewportOrg,因此, SetWindowExt,可用來修正縮放。

void CDCView::DoStartDoc()
{
   // get the default printer
   CPrintDialog dlg(FALSE);
   dlg.GetDefaults();

   // is a default printer set up?
   HDC hdcPrinter = dlg.GetPrinterDC();
   if (hdcPrinter == NULL)
   {
      MessageBox(_T("Buy a printer!"));
   }
   else
   {
      // create a CDC and attach it to the default printer
      CDC dcPrinter;
      dcPrinter.Attach(hdcPrinter);

      // call StartDoc() to begin printing
      DOCINFO docinfo;
      memset(&docinfo, 0, sizeof(docinfo));
      docinfo.cbSize = sizeof(docinfo);
      docinfo.lpszDocName = _T("CDC::StartDoc() Code Fragment");

      // if it fails, complain and exit gracefully 
      if (dcPrinter.StartDoc(&docinfo) < 0)
      {
        MessageBox(_T("Printer wouldn't initalize"));
      }
      else
      {
        // start a page 
        if (dcPrinter.StartPage() < 0)
        {
          MessageBox(_T("Could not start page"));
          dcPrinter.AbortDoc();
        }
        else
        {
          // actually do some printing
          CGdiObject* pOldFont = dcPrinter.SelectStockObject(SYSTEM_FONT);

          dcPrinter.TextOut(50, 50, _T("Hello World!"), 12);

          dcPrinter.EndPage();
          dcPrinter.EndDoc();
          dcPrinter.SelectObject(pOldFont);
        }
      }
   }
}

需求

Header: afxwin.h

請參閱

參考

CDC 類別

階層架構圖表

CDC::Escape

CDC::EndDoc

CDC::AbortDoc