PAGESETUPDLG (structure)

9/9/2008

Essa estrutura contém informações usadas pelo PageSetupDlg (função) Para inicializar o Configurar página caixa de diálogo comum.

Windows CE 2.10 e posterior, essa estrutura substitui PRINTDLG (estrutura).

Syntax

typedef struct tagPSD { 
  DWORD lStructSize; 
  HWND hwndOwner; 
  HGLOBAL hDevMode; 
  HGLOBAL hDevNames; 
  DWORD Flags; 
  POINT ptPaperSize; 
  RECT rtMinMargin; 
  RECT rtMargin; 
  HINSTANCE hInstance; 
  LPARAM lCustData; 
  LPPAGESETUPHOOK lpfnPageSetupHook; 
  LPPAGEPAINTHOOK lpfnPagePaintHook; 
  LPCTSTR lpPageSetupTemplateName; 
  HGLOBAL hPageSetupTemplate; 
} PAGESETUPDLG, *LPPAGESETUPDLG; 

Os membros

• lStructSize
  Especifica o tamanho, em bytes, dessa estrutura.

• 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.

• hDevMode
  Identificador para um objeto memória global que contém um DEVMODE estrutura. Na entrada, se um identificador for fornecido, os valores de correspondente DEVMODE estrutura são usados para inicializar os controles na caixa de diálogo. Na saída, a caixa diálogo define hDevMode Para um identificador global memória para um DEVMODE estrutura que contém valores especificando as seleções do usuário. Se as seleções do usuário não estiver disponível, os conjuntos caixa diálogo hDevMode para NULL.

• hDevNames
  Identificador para um objeto memória global que contém um DEVNAMES estrutura. Essa estrutura contém três seqüências de caracteres que especificar o nome driver, o nome da impressora e o nome porta saída. Na entrada, se um identificador for fornecido, as seqüências de caracteres de correspondente DEVNAMES estrutura são usados para inicializar controles na caixa de diálogo. Na saída, a caixa diálogo define hDevNames Para um identificador global memória para um DEVNAMES estrutura que contém as seqüências de caracteres especificando as seleções do usuário. Se as seleções do usuário não estiver disponível, os conjuntos caixa diálogo hDevNames para NULL.

• Sinalizadores
  Conjunto de sinalizadores bit que você pode usar para inicializar o PageSetup 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
  PSD_DEFAULTMINMARGINS	Não suportado.
  PSD_DISABLEMARGINS	Desativa os controles de margem, impedindo que o usuário configuração as margens.
  PSD_DISABLEORIENTATION	Desativa os controles orientação, impedindo que o usuário configuração orientação de página.
  PSD_DISABLEPAGEPAINTING	Não suportado.
  PSD_DISABLEPAPER	Desativa os controles de papel, impedindo que o usuário a partir de parâmetros página configuração such as o tamanho do papel e origem.
  PSD_DISABLEPRINTRANGE	Em Windows Embedded CE, desativa esse sinalizador de Imprimir Intervalo caixa GRUPO da caixa de diálogo.
  PSD_DISABLEPRINTER	Desativa o Impressora botão, impedindo que o usuário chamar uma caixa diálogo que contém informações instalação de impressora adicionais.
  PSD_ENABLEPAGEPAINTHOOK	Não suportado.
  PSD_ENABLEPAGESETUPHOOK	Permite que o procedimento gancho especificado na lpfnPageSetupHook membro.
  PSD_ENABLEPAGESETUPTEMPLATE	Indica que o hInstance e lpPageSetupTemplateName Membros especificar um modelo caixa diálogo para usar no local do modelo de usar como padrão.
  PSD_ENABLEPAGESETUPTEMPLATEHANDLE	Indica que o hPageSetupTemplate membro identifica um bloco dados que contém um modelo caixa diálogo pré-carregadas. O sistema ignora a lpPageSetupTemplateName membro Se este sinalizador é especificado.
  PSD_INHUNDREDTHSOFMILLIMETERS	Indica que centésimos de milímetros são a unidade de medida para as margens e papel tamanho. Os valores de rtMargin, rtMinMargin, e ptPaperSize Os membros são em centésimos de milímetros. Você pode definir esse sinalizador na entrada para substituir a unidade de medida para localidade do usuário a usar como padrão. Quando a função retorna, caixa de diálogo define esse sinalizador para indicar as unidades usadas.
  PSD_INTHOUSANDTHSOFINCHES	Indica que thousandths cm são a unidade de medida para as margens e papel tamanho. Os valores de rtMargin, rtMinMargin, e ptPaperSize Os membros são no thousandths de polegadas. Você pode definir esse sinalizador na entrada para substituir a unidade de medida para localidade do usuário a usar como padrão. Quando a função retorna, caixa de diálogo define esse sinalizador para indicar as unidades usadas.
  PSD_INWININIINTLMEASURE	Não suportado.
  PSD_MARGINS	Faz com que o sistema para usar os valores especificados na rtMargin membro como as larguras iniciais para a esquerda, parte superior, direito e margens inferior. Se PSD_MARGINS não estiver definido, o sistema define as larguras iniciais para one inch para todas as margens.
  PSD_MINMARGINS	Faz com que o sistema para usar os valores especificados na rtMinMargin membro como as larguras mínimas permitidas para a esquerda, parte superior, direito e margens inferior. O sistema impede que o usuário inserir uma largura menor que o mínimo especificado. Se PSD_MINMARGINS não for especificado, o sistema define as larguras permitidas mínimas aos permitido pela impressora.
  PSD_NONETWORKBUTTON	Não suportado.
  PSD_NOWARNING	Não suportado.
  PSD_RANGESELECTION	Em Windows Embedded CE, este define sinalizador a Seleção botão na caixa de diálogo como o intervalo de impressão usar como padrão. Se PSD_RANGESELECTION não é definido, o intervalo de impressão será definido para o Todos os botão.
  PSD_RETURNDEFAULT	PageSetupDlg Não exibir a caixa diálogo. Em vez disso, ele define o hDevNames e hDevMode Os membros alças para DEVMODE e DEVNAMES estruturas que são inicializadas para a impressora usar como padrão sistema. PageSetupDlg Retorna um erro se ambos hDevNames Ou hDevMode não é NULL.
  PSD_SHOWHELP	Não suportado.

• ptPaperSize
  Não suportado.

• rtMinMargin
  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 rtMargin membro. O sinalizador PSD_INTHOUSANDTHSOFINCHES ou PSD_INHUNDREDTHSOFMILLIMETERS indica as unidades de medida.

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

• hInstance
  Se o sinalizador PSD_ENABLEPAGESETUPTEMPLATE estiver definida na Sinalizadores membro, hInstance é o identificador para a instância aplicativo ou módulo que contém o modelo caixa diálogo nomeado pela lpPageSetupTemplateName membro.

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

• lpfnPageSetupHook
  Ponteiro longo para um PageSetupHook procedimento gancho que pode mensagens processo destinadas a caixa diálogo. Esse membro é ignorado a menos que o sinalizador PSD_ENABLEPAGESETUPHOOK é definido na Sinalizadores membro.

• lpfnPagePaintHook
  Não suportado.

• lpPageSetupTemplateName
  Ponteiro longo para um seqüência de caracteres NULL-Terminated que nomes de recurso modelo caixa diálogo no módulo identificado pelo hInstance membro. Este modelo é substituído para o padrão modelo caixa diálogo. Para obter recursos caixa diálogo numerada, lpPageSetupTemplateName Pode ser um valor retornado pela MAKEINTRESOURCE macro. Esse membro é ignorado a menos que o sinalizador PSD_ENABLEPAGESETUPTEMPLATE é definido na Sinalizadores membro.

• hPageSetupTemplate
  Se o sinalizador PSD_ENABLEPAGESETUPTEMPLATEHANDLE estiver definida na Sinalizadores membro, hPageSetupTemplate é o identificador para um objeto memória que contém um modelo caixa diálogo.

Remarks

Depois que o usuário fecha a caixa diálogo, o sistema retorna informações sobre os membros página User-defined essa estrutura.

Se os sinalizadores PSD_INHUNDREDTHSOFMILLIMETERS e PSD_INTHOUSANDTHSOFINCHES não forem especificados, o sistema consultará o valor LOCALE_IMEASURE de localidade de usuário usar como padrão para determinar a unidade de medida seja (centésimos de milímetros) ou thousandths de polegadas para as larguras de margem e tamanho de papel.

Se os dois hDevNames e hDevMode Ter válido alças e o nome da impressora especificado pelo wDeviceOffset membro das DEVNAMES estrutura não é o mesmo que o nome especificado pela dmDeviceName membro das DEVMODE estrutura, o sistema usa o nome especificado por wDeviceOffset , por padrão.

O PageSetupDlg função preenchimentos de DEVNAMES estrutura com byte desloca vez desloca o caractere esperado.

Requirements

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

See Also

Reference

PageSetupDlg (function)
PageSetupHook
WM_INITDIALOG
DEVNAMES
DEVMODE
MAKEINTRESOURCE
PRINTDLG (structure)