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_nCurPage CPrintInfo할당하여 인쇄할 문서의 페이지를 뷰 클래스에 알릴 수 있습니다. 뷰 클래스는 값을 검색하고 지정된 페이지의 실제 인쇄를 수행합니다.
또 다른 예는 인쇄될 때까지 문서의 길이를 알 수 없는 경우입니다. 이 경우 뷰 클래스는 페이지가 인쇄될 때마다 문서 끝에 대해 테스트합니다. 끝에 도달하면 뷰 클래스는 멤버 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_dwFlags m_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::OnPrepareDC CView::OnPrint 합니다. 해당 값은 반환된 값부터 반환된 GetFromPage GetToPage값까지 다양합니다. 문서의 지정한 페이지를 재정의 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