PageSetupDlg (function)
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função cria uma Configurar página caixa diálogo que permite que o usuário para especificar os atributos de uma página impressa. Esses atributos incluem o tamanho do papel e origem, orientação de página — de retrato ou paisagem — e a largura das margens da página.
Windows CE 2.10 e posterior, essa função substitui o PrintDlg (função) função.
Syntax
BOOL PageSetupDlg(
LPPAGESETUPDLG lppsd
);
Parameters
- lppsd
Ponteiro longo para um PAGESETUPDLG (estrutura) que contém informações usadas para inicializar a caixa diálogo. A estrutura recebe informações sobre as seleções do usuário quando a função retorna.
Return Value
Se o usuário clica a OK botão, o valor de retorno é diferente de zero. Os membros a PAGESETUPDLG estrutura apontado pelo lppsd parâmetro indicar as seleções do usuário.
Se o usuário cancela ou fecha o Configurar página caixa diálogo ou um erro ocorre, o valor de retorno é zero. Para informações de erro estendidas get, use o CommDlgExtendedError função. Um dos valores mostrados na seguinte tabela é retornada.
| Valor | Valor |
|---|---|
CDERR_DIALOGFAILURE |
CDERR_NOTEMPLATE |
CDERR_FINDRESFAILURE |
CDERR_REGISTRYFAILURE |
CDERR_INITIALIZATION |
CDERR_STRUCTSIZE |
CDERR_LOADRESFAILURE |
PDERR_CREATEDCFAILURE |
CDERR_LOADSTRFAILURE |
PDERR_NOPORTS |
CDERR_LOCKRESFAILURE |
PDERR_NOPRINTERS |
CDERR_MEMALLOCFAILURE |
PDERR_PRINTERNOTFOUND |
CDERR_NOHINSTANCE |
PDERR_RETDEFFAILURE |
CDERR_NOHOOK |
|
Para obter mais informações sobre esses valores de erro, consulte CommDlgExtendedError.
Remarks
O PageSetupDlg função não é com suporte na versão 2.0.
Para criar seu próprios diálogo de impressão, você deve usar o modelo diálogo. Itens neste modelo não podem ser excluídos no entanto, itens podem ser ocultos, modificados e adicionados.
O PageSetupDlg função preenchimentos de DEVNAMES estrutura com byte desloca vez desloca o caractere esperado.
Requirements
| Header | commdlg.h |
| Library | commdlg.lib |
| Windows Embedded CE | Windows CE 2.10 and later |
See Also
Reference
CommDlgExtendedError
PrintDlg (function)
DEVNAMES
PAGESETUPDLG (structure)