다음을 통해 공유


CPrintInfo 구조체

인쇄 또는 인쇄 미리 보기 작업에 대한 정보를 저장합니다.

구문

struct CPrintInfo

멤버

공용 메서드

이름 설명
CPrintInfo::GetFromPage 인쇄되는 첫 번째 페이지의 수를 반환합니다.
CPrintInfo::GetMaxPage 문서의 마지막 페이지 번호를 반환합니다.
CPrintInfo::GetMinPage 문서의 첫 번째 페이지 번호를 반환합니다.
CPrintInfo::GetOffsetPage 결합된 DocObject 인쇄 작업에서 인쇄되는 DocObject 항목의 첫 번째 페이지 앞의 페이지 수를 반환합니다.
CPrintInfo::GetToPage 인쇄할 마지막 페이지의 수를 반환합니다.
CPrintInfo::SetMaxPage 문서의 마지막 페이지 수를 설정합니다.
CPrintInfo::SetMinPage 문서의 첫 번째 페이지 수를 설정합니다.

공용 데이터 멤버

이름 설명
CPrintInfo::m_bContinuePrinting 프레임워크가 인쇄 루프를 계속해야 하는지 여부를 나타내는 플래그를 포함합니다.
CPrintInfo::m_bDirect 인쇄 대화 상자를 표시하지 않고 문서를 직접 인쇄할지 여부를 나타내는 플래그를 포함합니다.
CPrintInfo::m_bDocObject 인쇄 중인 문서가 DocObject인지 여부를 나타내는 플래그를 포함합니다.
CPrintInfo::m_bPreview 문서를 미리 보는지 여부를 나타내는 플래그를 포함합니다.
CPrintInfo::m_dwFlags DocObject 인쇄 작업을 지정합니다.
CPrintInfo::m_lpUserData 사용자가 만든 구조체에 대한 포인터를 포함합니다.
CPrintInfo::m_nCurPage 현재 인쇄 중인 페이지 수를 식별합니다.
CPrintInfo::m_nJobNumber 현재 인쇄 작업에 대해 운영 체제에서 할당한 작업 번호를 지정합니다.
CPrintInfo::m_nNumPreviewPages 미리 보기 창에 표시되는 페이지 수를 식별합니다. 1 또는 2 중 하나.
CPrintInfo::m_nOffsetPage 결합된 DocObject 인쇄 작업에서 특정 DocObject의 첫 번째 페이지의 오프셋을 지정합니다.
CPrintInfo::m_pPD 인쇄 대화 상자에 사용되는 개체에 CPrintDialog 대한 포인터를 포함합니다.
CPrintInfo::m_rectDraw 현재 사용할 수 있는 페이지 영역을 정의하는 사각형을 지정합니다.
CPrintInfo::m_strPageDesc 페이지 번호 표시에 대한 형식 문자열을 포함합니다.

설명

CPrintInfo 는 구조체이며 기본 클래스가 없습니다.

프레임워크는 인쇄 또는 인쇄 미리 보기 명령을 선택할 때마다 개체 CPrintInfo 를 만들고 명령이 완료되면 삭제합니다.

CPrintInfo에는 인쇄할 페이지 범위와 현재 인쇄 중인 페이지와 같은 인쇄 작업의 현재 상태 같은 인쇄 작업 전체에 대한 정보가 포함됩니다. 일부 정보는 연결된 CPrintDialog 개체에 저장됩니다. 이 개체에는 인쇄 대화 상자에서 사용자가 입력한 값이 포함됩니다.

CPrintInfo 개체는 인쇄 프로세스 중에 프레임워크와 뷰 클래스 간에 전달되며 둘 사이의 정보를 교환하는 데 사용됩니다. 예를 들어 프레임워크는 뷰 클래스에 값을 m_nCurPageCPrintInfo할당하여 인쇄할 문서의 페이지를 뷰 클래스에 알릴 수 있습니다. 뷰 클래스는 값을 검색하고 지정된 페이지의 실제 인쇄를 수행합니다.

또 다른 예는 인쇄될 때까지 문서의 길이를 알 수 없는 경우입니다. 이 경우 뷰 클래스는 페이지가 인쇄될 때마다 문서 끝에 대해 테스트합니다. 끝에 도달하면 뷰 클래스는 멤버 CPrintInfo 를 FALSE로 설정합니다m_bContinuePrinting. 그러면 프레임워크에 인쇄 루프를 중지하도록 알릴 수 있습니다.

CPrintInfo는 "참고 항목CView"에 나열된 멤버 함수에서 사용됩니다. Microsoft Foundation 클래스 라이브러리에서 제공하는 인쇄 아키텍처에 대한 자세한 내용은 프레임 창 및 문서/보기 아키텍처인쇄인쇄 문서: 다중 페이지 문서를 참조하세요.

상속 계층 구조

CPrintInfo

요구 사항

헤더: afxext.h

CPrintInfo::GetFromPage

이 함수를 호출하여 인쇄할 첫 번째 페이지의 수를 검색합니다.

UINT GetFromPage() const;

Return Value

인쇄할 첫 번째 페이지의 번호입니다.

설명

인쇄 대화 상자에서 사용자가 지정한 값이며 멤버가 참조하는 CPrintDialog 개체에 m_pPD 저장됩니다. 사용자가 값을 지정하지 않은 경우 기본값은 문서의 첫 번째 페이지입니다.

CPrintInfo::GetMaxPage

이 함수를 호출하여 문서의 마지막 페이지 수를 검색합니다.

UINT GetMaxPage() const;

Return Value

문서의 마지막 페이지 번호입니다.

설명

이 값은 멤버가 참조하는 CPrintDialog 개체에 m_pPD 저장됩니다.

CPrintInfo::GetMinPage

이 함수를 호출하여 문서의 첫 번째 페이지 수를 검색합니다.

UINT GetMinPage() const;

Return Value

문서의 첫 번째 페이지 번호입니다.

설명

이 값은 멤버가 참조하는 CPrintDialog 개체에 m_pPD 저장됩니다.

CPrintInfo::GetOffsetPage

DocObject 클라이언트에서 여러 DocObject 항목을 인쇄할 때 오프셋을 검색하려면 이 함수를 호출합니다.

UINT GetOffsetPage() const;

Return Value

결합된 DocObject 인쇄 작업에서 인쇄되는 DocObject 항목의 첫 번째 페이지 앞의 페이지 수입니다.

설명

이 값은 멤버가 참조합니다 m_nOffsetPage . 문서의 첫 번째 페이지는 다른 활성 문서와 함께 DocObject로 인쇄될 때 값 + 1로 번호가 매겨 m_nOffsetPage 질 것입니다. 멤버는 m_nOffsetPage 값이 TRUE인 m_bDocObject 경우에만 유효합니다.

CPrintInfo::GetToPage

이 함수를 호출하여 인쇄할 마지막 페이지 수를 검색합니다.

UINT GetToPage() const;

Return Value

인쇄할 마지막 페이지의 번호입니다.

설명

인쇄 대화 상자에서 사용자가 지정한 값이며 멤버가 참조하는 CPrintDialog 개체에 m_pPD 저장됩니다. 사용자가 값을 지정하지 않은 경우 기본값은 문서의 마지막 페이지입니다.

CPrintInfo::m_bContinuePrinting

프레임워크가 인쇄 루프를 계속해야 하는지 여부를 나타내는 플래그를 포함합니다.

설명

인쇄 시간 페이지 매김을 수행하는 경우 문서의 끝에 도달한 후 재정의 CView::OnPrepareDC 에서 이 멤버를 FALSE로 설정할 수 있습니다. 멤버 함수를 사용하여 SetMaxPage 인쇄 작업의 시작 부분에 문서의 길이를 지정한 경우에는 이 변수를 수정할 필요가 없습니다. 멤버는 m_bContinuePrinting BOOL 형식의 공용 변수입니다.

CPrintInfo::m_bDirect

직접 인쇄를 위해 인쇄 대화 상자를 무시하면 프레임워크에서 이 멤버를 TRUE로 설정합니다. 그렇지 않으면 FALSE입니다.

설명

인쇄 대화 상자는 일반적으로 셸에서 인쇄하거나 명령 ID ID_FILE_PRINT_DIRECT 사용하여 인쇄를 수행할 때 무시됩니다.

일반적으로 이 멤버를 변경하지는 않지만 변경한 경우 CView::OnPreparePrinting 재정의에서 CView::D oPreparePrinting을 호출하기 전에 변경합니다.

CPrintInfo::m_bDocObject

인쇄 중인 문서가 DocObject인지 여부를 나타내는 플래그를 포함합니다.

설명

이 플래그가 TRUE가 아니면 데이터 멤버 m_dwFlagsm_nOffsetPage 이며 유효하지 않습니다.

CPrintInfo::m_bPreview

문서를 미리 보는지 여부를 나타내는 플래그를 포함합니다.

설명

이는 사용자가 실행한 명령에 따라 프레임워크에 의해 설정됩니다. 인쇄 미리 보기 작업에 대해서는 인쇄 대화 상자가 표시되지 않습니다. 멤버는 m_bPreview BOOL 형식의 공용 변수입니다.

CPrintInfo::m_dwFlags

DocObject 인쇄 작업을 지정하는 플래그의 조합을 포함합니다.

설명

데이터 멤버 m_bDocObject 가 TRUE인 경우에만 유효합니다.

플래그는 다음 값 중 하나 이상이 될 수 있습니다.

  • PRINTFLAG_MAYBOTHERUSER

  • PRINTFLAG_PROMPTUSER

  • PRINTFLAG_USERMAYCHANGEPRINTER

  • PRINTFLAG_RECOMPOSETODEVICE

  • PRINTFLAG_DONTACTUALLYPRINT

  • PRINTFLAG_FORCEPROPERTIES

  • PRINTFLAG_PRINTTOFILE

CPrintInfo::m_lpUserData

사용자가 만든 구조체에 대한 포인터를 포함합니다.

설명

이를 사용하여 보기 클래스에 저장하지 않으려는 인쇄 관련 데이터를 저장할 수 있습니다. 멤버는 m_lpUserData LPVOID 형식의 공용 변수입니다.

CPrintInfo::m_nCurPage

현재 페이지의 번호를 포함합니다.

설명

프레임워크는 매번 이 멤버에 대해 다른 값을 지정하여 문서의 각 페이지에 대해 한 번 호출 CView::OnPrepareDCCView::OnPrint 합니다. 해당 값은 반환된 값부터 반환된 GetFromPageGetToPage값까지 다양합니다. 문서의 지정한 페이지를 재정의 CView::OnPrepareDC 하고 CView::OnPrint 인쇄하려면 이 멤버를 사용합니다.

미리 보기 모드가 처음 호출되면 프레임워크는 이 멤버의 값을 읽어 처음에 미리 볼 문서의 페이지를 결정합니다. 미리 보기 모드로 전환할 때 문서에서 사용자의 현재 위치를 기본 확인하기 위해 재정 CView::OnPreparePrinting 의에서 이 멤버의 값을 설정할 수 있습니다. 멤버는 m_nCurPage UINT 형식의 공용 변수입니다.

CPrintInfo::m_nJobNumber

현재 인쇄 작업에 대해 운영 체제에서 할당한 작업 번호를 나타냅니다.

설명

이 값은 작업이 아직 인쇄되지 않았거나(즉, 개체가 새로 생성되어 인쇄에 아직 사용되지 않은 경우 CPrintInfo ) 또는 작업을 시작하는 동안 오류가 발생한 경우 SP_ERROR 수 있습니다.

CPrintInfo::m_nNumPreviewPages

미리 보기 모드로 표시되는 페이지 수를 포함합니다. 1 또는 2일 수 있습니다.

설명

멤버는 m_nNumPreviewPages UINT 형식의 공용 변수입니다.

CPrintInfo::m_nOffsetPage

결합된 DocObject 인쇄 작업에서 특정 DocObject의 첫 번째 페이지 앞에 오는 페이지 수를 포함합니다.

CPrintInfo::m_pPD

인쇄 작업의 인쇄 대화 상자를 표시하는 데 사용되는 개체에 대한 포인터 CPrintDialog 를 포함합니다.

설명

멤버는 m_pPD 포인터로 선언된 public 변수입니다 CPrintDialog.

CPrintInfo::m_rectDraw

논리적 좌표로 페이지의 사용 가능한 그리기 영역을 지정합니다.

설명

재정의 CView::OnPrint에서 이를 참조할 수 있습니다. 이 멤버를 사용하여 머리글, 바닥글 등을 인쇄한 후 사용할 수 있는 영역기본을 추적할 수 있습니다. 멤버는 m_rectDraw 형식 CRect의 공용 변수입니다.

CPrintInfo::m_strPageDesc

인쇄 미리 보기 중에 페이지 번호를 표시하는 데 사용되는 형식 문자열을 포함합니다. 이 문자열은 두 개의 부분 문자열로 구성됩니다. 하나는 단일 페이지 표시용이고 다른 하나는 두 페이지 표시용으로 구성되며 각각 '\n' 문자로 종료됩니다.

설명

프레임워크는 기본값으로 "Page %u\nPages %u-%u\n"을(를) 사용합니다. 페이지 번호에 대해 다른 형식을 원하는 경우 재정의 CView::OnPreparePrinting에 서식 문자열을 지정합니다. 멤버는 m_strPageDesc 형식 CString의 공용 변수입니다.

CPrintInfo::SetMaxPage

이 함수를 호출하여 문서의 마지막 페이지 수를 지정합니다.

void SetMaxPage(UINT nMaxPage);

매개 변수

nMaxPage
문서의 마지막 페이지 수입니다.

설명

이 값은 멤버가 참조하는 CPrintDialog 개체에 m_pPD 저장됩니다. 문서의 길이가 인쇄되기 전에 알려진 경우 재정의에서 이 함수를 호출합니다 CView::OnPreparePrinting. 문서의 길이가 인쇄 대화 상자에서 사용자가 지정한 설정에 따라 달라지는 경우 재정의 CView::OnBeginPrinting에서 이 함수를 호출합니다. 문서의 길이를 인쇄할 때까지 알 수 없는 경우 해당 멤버를 m_bContinuePrinting 사용하여 인쇄 루프를 제어합니다.

예시

CView::OnPreparePrinting에 대한 예제를 참조하세요.

CPrintInfo::SetMinPage

이 함수를 호출하여 문서의 첫 번째 페이지 수를 지정합니다.

void SetMinPage(UINT nMinPage);

매개 변수

nMinPage
문서의 첫 번째 페이지 수입니다.

설명

페이지 번호는 일반적으로 1부터 시작합니다. 이 값은 멤버가 참조하는 CPrintDialog 개체에 m_pPD 저장됩니다.

참고 항목

MFC 샘플 DIBLOOK
계층 구조 차트
CView::OnBeginPrinting
CView::OnEndPrinting
CView::OnEndPrintPreview
CView::OnPrepareDC
CView::OnPreparePrinting
CView::OnPrint