PAGESETUPDLG

A PAGESETUPDLG estrutura contém informações que usa o PageSetupDlg função para inicializar a caixa de diálogo Page Setup comum. Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre os parâmetros de página definido pelo usuário nessa estrutura.

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

 

Membros

lStructSize
Especifica o tamanho, em bytes, dessa estrutura.
hwndOwner
Identifica a janela que possui a caixa de diálogo. Esse membro pode ser qualquer válido identificador janela, ou ele pode ser NULL se a caixa de diálogo não possui nenhum proprietário.
hDevMode
Identificador para um objeto memória global que contém um estrutura de DEVMODE . Na entrada, se um identificador é dado, os valores da estrutura DEVMODE correspondentes são usados para inicializar os controles na caixa de diálogo. Na saída, o diálogo caixa define hDevMode para um identificador de memória global para uma estrutura DEVMODE que contém valores que especificar as seleções do usuário. Se as seleções do usuário não estiverem disponíveis, a caixa de diálogo define hDevMode como NULL.
hDevNames
Identificador para um objeto memória global que contém uma estrutura DEVNAMES . Essa estrutura contém três seqüências de caracteres que especifica o nome do driver, o nome da impressora e o nome da porta de saída. Na entrada, se um identificador é dada, as seqüências de caracteres na estrutura de DEVNAMES correspondente são usadas para inicializar os controles na caixa de diálogo. Na saída, o diálogo caixa define hDevNames para um identificador de memória global para uma estrutura DEVNAMES contém seqüências de caracteres especificando as seleções do usuário. Se as seleções do usuário não estiverem disponíveis, a caixa de diálogo define o hDevNames para NULL.
Sinalizadores
Um conjunto de bit sinalizadores que você pode usar para inicializar a caixa de diálogo Page Setup comum. Quando a caixa de diálogo retorna, ele define esses sinalizadores para indicar a entrada do usuário. Esse membro pode ser uma combinação dos sinalizadores a seguir:
PSD_DEFAULTMINMARGINS
Define os valores mínimos que o usuário pode especificar para as margens da página ser as margens mínimas permitidas pela impressora. Este é o padrão. Este sinalizador será ignorado se o PSD_MARGINS e PSD_MINMARGINS sinalizadores é especificado também.
PSD_DISABLEMARGINS
Desabilita os controles de margem, impedindo que o usuário definir as margens.
PSD_DISABLEORIENTATION
Desabilita os controles de orientação, impedindo que o usuário definir a orientação da página.
PSD_DISABLEPAGEPAINTING
Impede que a caixa de diálogo desenho do conteúdo da página de amostra. Se você habilitar um procedimento de gancho de PagePaintHook , você ainda pode desenhar o conteúdo da página de amostra.
PSD_DISABLEPAPER
Desabilita os controles de papel, impedindo que o usuário definindo parâmetros de página, como o tamanho do papel e fonte.
PSD_DISABLEPRINTER
Desativa o botão ' impressora ', impedindo que o usuário invoca uma caixa de diálogo que contém informações de configuração de impressora adicionais.
PSD_ENABLEPAGEPAINTHOOK
Permite que o procedimento gancho especificado na lpfnPagePaintHook membro.
PSD_ENABLEPAGESETUPHOOK
Permite que o procedimento gancho especificado na lpfnPageSetupHook membro.
PSD_ENABLEPAGESETUPTEMPLATE
Indica que o hInstance e lpPageSetupTemplateName Membros especificar um modelo de caixa de diálogo para usar no lugar do modelo 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 o lpPageSetupTemplateName membro se este sinalizador for especificado.
PSD_INHUNDREDTHSOFMILLIMETERS
Indica que os centésimos de milímetros são a unidade de medida para as margens e tamanho do papel. Os valores nos membros rtMargin, rtMinMargine ptPaperSize estão em centésimos de milímetros. Você pode definir esse sinalizador na entrada para substituir a unidade de medida para a localidade do usuário padrão. Quando a função retorna, a caixa de diálogo define esse sinalizador para indicar as unidades usadas.
PSD_INTHOUSANDTHSOFINCHES
Indica que milésimos de polegadas são a unidade de medida para as margens e tamanho do papel. Os valores rtMargin, rtMinMargine ptPaperSize Membros são em milésimos de polegadas. Você pode definir esse sinalizador na entrada para substituir a unidade de medida para a localidade do usuário padrão. Quando a função retorna, a caixa de diálogo define esse sinalizador para indicar as unidades usadas.
PSD_INWININIINTLMEASURE
Não implementado.
PSD_MARGINS
Faz com que o sistema para usar os valores especificados no membro rtMargin como as larguras iniciais para a esquerda, superior, direito e margens inferior. Se PSD_MARGINS não estiver definido, o sistema define as larguras iniciais para uma polegada para todas as margens.
PSD_MINMARGINS
Faz com que o sistema para usar os valores especificados no membro rtMinMargin como as larguras mínimas permitidas para a esquerda, 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 mínimas permitidas para aqueles permitido pela impressora.
PSD_NONETWORKBUTTON
Oculta e desativa o botão ' rede '.
PSD_NOWARNING
Impede que o sistema exiba uma mensagem de aviso quando não há nenhuma impressora padrão.
PSD_RETURNDEFAULT
PageSetupDlg não exibir a caixa de diálogo. Em vez disso, ele define o hDevNames e hDevMode Membros para alças para DEVMODE de DEVNAMES estruturas que são inicializadas para a impressora padrão de sistema. PageSetupDlg retornará um erro se o hDevNames ou hDevMode não é nulo.
PSD_SHOWHELP
Faz com que a caixa de diálogo Exibir no botão Ajuda . O hwndOwner membro deve especificar a janela para receber a HELPMSGSTRING registadas mensagens de caixa de diálogo envia quando o usuário clica no botão Ajuda.

ptPaperSize
Especifica as dimensões do papel selecionado pelo usuário. O sinalizador PSD_INTHOUSANDTHSOFINCHES ou PSD_INHUNDREDTHSOFMILLIMETERS indica as unidades de medida.
rtMinMargin
Especifica as larguras mínimas permitidas para a esquerda, superior, direito e margens inferior. O sistema ignora esta membro se o sinalizador PSD_MINMARGINS não está definido. Estes valores devem ser menor ou igual aos valores especificados no membro rtMargin . O sinalizador PSD_INTHOUSANDTHSOFINCHES ou PSD_INHUNDREDTHSOFMILLIMETERS indica as unidades de medida.
rtMargin
Especifica as larguras da esquerda, 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 é definido na sinalizadores membro, hInstance é o identificador do pedido ou da instância do 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 membro lpfnPageSetupHook . Quando o sistema envia o WM_INITDIALOG mensagem para o procedimento gancho, lParam parâmetro a mensagem é que um ponteiro para a estrutura PAGESETUPDLG especificado quando o diálogo foi criado. O procedimento de gancho pode usar esse ponteiro para obter o valor de lCustData.
lpfnPageSetupHook
Ponteiro para um PageSetupHook procedimento gancho que pode mensagens processo destinadas a caixa de diálogo. Esse membro é ignorado a menos que o sinalizador PSD_ENABLEPAGESETUPHOOK é definido na sinalizadores membro.
lpfnPagePaintHook
Ponteiro para um PagePaintHook procedimento gancho que recebe WM_PSD_ * mensagens da caixa de diálogo sempre que a página de exemplo é redesenhada. Por processamento de mensagens, o procedimento de gancho pode personalizar a aparência da página de amostra. Esse membro é ignorado a menos que o sinalizador PSD_ENABLEPAGEPAINTHOOK é definido na sinalizadores membro.
lpPageSetupTemplateName
Ponteiro para uma seqüência de caracteres null-terminated que nomeia o recurso de modelo caixa diálogo no módulo identificado pelo hInstance membro. Este modelo é substituído para o padrão modelo caixa diálogo. Para recursos de caixa de 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 é definido na sinalizadores membro, hPageSetupTemplate é o identificador de um objeto de memória que contém um modelo caixa diálogo.

Observações

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

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

QuickInfo

nbsp; Windows &NT: requer versão 3.51 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declaradas no commdlg.h.
Unicode:Definidos como estruturas ANSI e Unicode.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, estruturas de caixa de diálogo comuns, DEVMODE, DEVNAMES, MAKEINTRESOURCE, PagePaintHook, PageSetupDlg, PageSetupHook, WM_INITDIALOG

Index