PRINTDLG (structure)

9/9/2008

Essa estrutura contém informações PrintDlg (função) usa ao inicializar o Imprimir caixa de diálogo comum. Depois que um usuário fecha a caixa diálogo, o sistema usa essa estrutura para retornar informações sobre seleções opção de impressão do usuário a.

Windows CE 2.10 e posterior, esta estrutura foi substituída pelo PAGESETUPDLG (estrutura).

Syntax

typedef struct tagPD {
  DWORD cbStruct;
  HWND hwndOwner;
  HDC hdc;
  DWORD dwFlags;
  RECT rcMinMargin;
  RECT rcMargin;
  HINSTANCE hinst;
  LPARAM lCustData;
  LPPRINTHOOKPROC pfnPrintHook;
  LPCTSTR pszPrintTemplateName;
  HGLOBAL hglbPrintTemplateResource;
} PRINTDLG , *LPPRINTDLG;

Os membros

• cbStruct
  Especifica o tamanho estrutura, em bytes.

• hwndOwner
  Identificador para a janela proprietária caixa de diálogo. Esse membro pode ser qualquer válido identificador janela, ou ele pode ser NULL se a caixa diálogo não possui nenhum proprietário.

• hDC
  Quando PrintDlg Retorna, hDC Contém o identificador para o contexto dispositivo da impressora.

• dwFlags
  Especifica um máscara de bits dos sinalizadores usados para inicializar o Imprimir caixa de diálogo comum. Quando a caixa diálogo retorna, ele define esses sinalizadores para indicar entrada do usuário. Ele pode ser uma combinação do seguinte sinalizadores.

  Valor	Descrição
  PD_SELECTALLPAGES	Na entrada, faz com que esse sinalizador de Todos os botão de opção ser selecionado quando a caixa diálogo é criada. Na saída, ele indica que o usuário selecionado a Todos os botão de opção.
  PD_SELECTSELECTION	Na entrada, faz com que esse sinalizador de Seleção botão de opção estar no estado selecionado quando a caixa diálogo é criada. Na saída, ele indica que o usuário selecionado a Seleção botão de opção. Se este sinalizador não for especificado, o Todos os botão de opção é Por padrão selecionado.
  PD_SELECTDRAFTMODE	Indica o usuário selecionado a Modo de rascunho caixa de seleção.
  PD_SELECTA4	Indica que o usuário selecionado papel tamanho A4.
  PD_SELECTLETTER	Indica o papel tamanho letra usuário selecionado.
  PD_SELECTINFRARED	Indica que o usuário selecionado a porta de impressora de infravermelho.
  PD_SELECTSERIAL	Indica que o usuário selecionada a serial porta de impressora.
  PD_DISABLEPAPERSIZE	Desativa seleção tamanho do papel.
  PD_DISABLEPRINTRANGE	Desativa imprime seleção intervalo.
  PD_DISABLEMARGINS	Desativa a margem seleção.
  PD_DISABLEORIENTATION	Desativa seleção orientação página.
  PD_RETURNDEFAULTDC	Retorna o contexto dispositivo (DC) da impressora usar como padrão sem exibir o diálogo.
  PD_ENABLEPRINTHOOK	Permite que o procedimento gancho especificado na pfnPrintHook membro. Isso permite que o procedimento gancho para o Imprimir caixa diálogo.
  PD_ENABLEPRINTTEMPLATE	Indica que o hinst e pszPrintTemplateName Um modelo caixa de diálogo para usar no local do modelo de usar como padrão para especificar os membros a Imprimir caixa diálogo.
  PD_ENABLEPRINTTEMPLATEHANDLE	Indica que o hglbPrintTemplateResource membro identifica um bloco dados que contém um modelo caixa diálogo pré-carregadas. O sistema usa esse modelo no local do modelo de usar como padrão para a Imprimir caixa diálogo. O sistema ignora a pszPrintTemplateName membro Se este sinalizador é especificado.
  PD_SELECTPORTRAIT	Na entrada, este sinalizador especifica o Imprimir caixa diálogo deve ser inicializada com orientação retrato selecionada como o usar como padrão. Na saída, este sinalizador indica que o usuário selecionado orientação retrato.
  PD_SELECTLANDSCAPE	Na entrada, este sinalizador especifica o Imprimir caixa diálogo deve ser inicializada com orientação paisagem selecionada como o usar como padrão. Na saída, este sinalizador indica que o usuário selecionado orientação paisagem.
  PD_MARGINS	Na entrada, este sinalizador especifica que o rcMargin membro contém valores de margem inicial. Na saída, ele indica que o rcMargin membro contém valores de margem especificadas pelo usuário.
  	Se este sinalizador não for especificado, o Imprimir caixa diálogo usa as margens usar como padrão, que são 1 inch para as margens inferior e parte superior e 1.25 Inches para a esquerda e direito margens.
  PD_INTHOUSANDTHSOFINCHES	Indica a unidade de medida na qual as margens são especificadas. Se este sinalizador nem o sinalizador PD_INHUNDREDTHSOFMILLIMETERS for especificada, o Imprimir caixa diálogo usa a configuração LOCALE_IMEASURE na tabela a localidade para determinar se deseja usar dos EUA sistema de medidas ou o sistema métrico.
  PD_INHUNDREDTHSOFMILLIMETERS	Indica a unidade de medida na qual as margens são especificadas. Se este sinalizador nem o sinalizador PD_INHUNDREDTHSOFMILLIMETERS for especificada, o Imprimir caixa diálogo usa a configuração LOCALE_IMEASURE na tabela a localidade para determinar se deseja usar dos EUA sistema de medidas ou o sistema métrico.
  PD_MINMARGINS	Na entrada, este sinalizador especifica que o rcMinMargin membro contém valores de margem mínima inicial. Na saída-indica que o rcMinMargin membro contém valores de margem mínima especificada pelo usuário. Se o valor na rcMinMargin membro é zero na saída, isso significa que o usuário não especificar os valores de margem mínima.

• rcMargin
  Especifica a largura da esquerda, parte superior, direito e margens inferior. Se você definir o sinalizador PSD_MARGINS, rcMargin Especifica os valores de margem inicial. Quando PrintDlg Retorna, rcMargin Contém as larguras de margem selecionadas pelo usuário. O sinalizador PSD_INHUNDREDTHSOFMILLIMETERS ou PSD_INTHOUSANDTHSOFINCHES indica as unidades de medida.

• rcMinMargin
  Especifica as larguras mínimas permitidas para a esquerda, parte superior, direito e margens inferior. O sistema ignora esta membro se o sinalizador PSD_MINMARGINS não estiver definida. Esses valores devem ser menor ou igual a os valores especificados na rcMargin membro. O sinalizador PSD_INTHOUSANDTHSOFINCHES ou PSD_INHUNDREDTHSOFMILLIMETERS indica as unidades de medida.

• hinst
  Identificador de instância de aplicativo ou módulo que contém o modelo caixa diálogo nomeado pela pszPrintTemplateName membro. Esse membro é válido somente se o sinalizador PD_ENABLEPRINTTEMPLATE ou PD_ENABLESETUPTEMPLATE é definida na dwFlags membro.

• lCustData
  Especifica dados Application-defined que o sistema passa para o procedimento gancho identificado pelo pfnPrintHook membro. Quando o sistema envia o WM_INITDIALOG mensagem para do o gancho procedimento, a mensagem lParam parâmetro é um ponteiro para o PRINTDLG estrutura especificado quando o diálogo foi criado. Procedimento de gancho pode usar esse ponteiro para get a lCustData valor.

• pfnPrintHook
  Ponteiro para um PrintHookProc procedimento gancho que pode mensagens processo destinadas a Imprimir caixa diálogo. Esse membro é ignorado a menos que o sinalizador PD_ENABLEPRINTHOOK é definido na Sinalizadores membro.

• pszPrintTemplateName
  Ponteiro para uma seqüência de caracteres NULL-Terminated que nomeia um recurso modelo caixa diálogo no módulo identificado pelo hinst membro. Este modelo é substituído para o padrão modelo caixa diálogo de impressão. Esse membro é ignorado a menos que o sinalizador PD_ENABLEPRINTTEMPLATE é definido na Sinalizadores membro.

• hglbPrintTemplateResource
  Se o sinalizador PD_ENABLEPRINTTEMPLATEHANDLE estiver definida na Sinalizadores membro, hglbPrintTemplateResource é o identificador para um objeto memória que contém um modelo caixa diálogo. Este modelo é substituído para o padrão Imprimir modelo caixa diálogo.

Remarks

Se o aplicativo não especificar a orientação do papel, a Imprimir caixa diálogo lê a orientação do papel última o usuário selecionado, o qual ele salvo para o Registro. Se não houver nenhum valor no Registro, a caixa diálogo seleciona de retrato como a usar como padrão. Caixa de diálogo também usa a última impressora, porta e tamanho de papel de usuário selecionado. Se esses valores não estiverem no Registro, a caixa diálogo seleciona a primeira impressora, primeira porta e um tamanho de papel que seja apropriado para a configuração regional como os padrões.

Requirements

Header	commdlg.h
Windows Embedded CE	Windows CE 2.0 and later

See Also

Reference

PrintDlg (function)
PrintHookProc
PAGESETUPDLG (structure)
WM_INITDIALOG