Estrutura PAGESETUPDLGA (commdlg.h)

Contém informações que a função PageSetupDlg usa para inicializar a caixa de diálogo Configurar Página . Depois que o usuário fecha a caixa de diálogo, o sistema retorna informações sobre os parâmetros de página definidos pelo usuário nessa estrutura.

Sintaxe

typedef struct tagPSDA {
  DWORD           lStructSize;
  HWND            hwndOwner;
  HGLOBAL         hDevMode;
  HGLOBAL         hDevNames;
  DWORD           Flags;
  POINT           ptPaperSize;
  RECT            rtMinMargin;
  RECT            rtMargin;
  HINSTANCE       hInstance;
  LPARAM          lCustData;
  LPPAGESETUPHOOK lpfnPageSetupHook;
  LPPAGEPAINTHOOK lpfnPagePaintHook;
  LPCSTR          lpPageSetupTemplateName;
  HGLOBAL         hPageSetupTemplate;
} PAGESETUPDLGA, *LPPAGESETUPDLGA;

Membros

lStructSize

Tipo: DWORD

O tamanho, em bytes, dessa estrutura.

hwndOwner

Digite: HWND

Um identificador para a janela que possui a caixa de diálogo. Esse membro pode ser qualquer identificador de janela válido ou nulo se a caixa de diálogo não tiver proprietário.

hDevMode

Tipo: HGLOBAL

Um identificador para um objeto de memória global que contém uma estrutura DEVMODE . Na entrada, se um identificador for especificado, os valores na estrutura DEVMODE correspondente serão usados para inicializar os controles na caixa de diálogo. Na saída, a caixa de diálogo define hDevMode como um identificador de memória global para uma estrutura DEVMODE que contém valores que especificam as seleções do usuário. Se as seleções do usuário não estiverem disponíveis, a caixa de diálogo definirá hDevMode como NULL.

hDevNames

Tipo: HGLOBAL

Um identificador para um objeto de memória global que contém uma estrutura DEVNAMES . Essa estrutura contém três cadeias de caracteres que especificam o nome do driver, o nome da impressora e o nome da porta de saída. Na entrada, se um identificador for especificado, as cadeias de caracteres na estrutura DEVNAMES correspondente serão usadas para inicializar controles na caixa de diálogo. Na saída, a caixa de diálogo define hDevNames como um identificador de memória global para uma estrutura DEVNAMES que contém cadeias de caracteres que especificam as seleções do usuário. Se as seleções do usuário não estiverem disponíveis, a caixa de diálogo definirá hDevNames como NULL.

Flags

Tipo: DWORD

Um conjunto de sinalizadores de bits que você pode usar para inicializar a caixa de diálogo Configuração de Página . Quando a caixa de diálogo é retornada, ela define esses sinalizadores para indicar a entrada do usuário. Esse membro pode ser um ou mais dos valores a seguir.

ptPaperSize

Tipo: POINT

As dimensões do papel selecionadas pelo usuário. O sinalizador PSD_INTHOUSANDTHSOFINCHES ou PSD_INHUNDREDTHSOFMILLIMETERS indica as unidades de medida.

rtMinMargin

Tipo: RECT

As larguras mínimas permitidas para as margens esquerda, superior, direita e inferior. O sistema ignorará esse membro se o sinalizador PSD_MINMARGINS não estiver definido. Esses valores devem ser menores ou iguais aos valores especificados no membro rtMargin . O sinalizador PSD_INTHOUSANDTHSOFINCHES ou PSD_INHUNDREDTHSOFMILLIMETERS indica as unidades de medida.

rtMargin

Tipo: RECT

As larguras das margens esquerda, superior, direita e inferior. Se você definir o sinalizador PSD_MARGINS , rtMargin especificará 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

Tipo: HINSTANCE

Se o sinalizador PSD_ENABLEPAGESETUPTEMPLATE estiver definido no membro Flags , hInstance será um identificador para a instância do aplicativo ou módulo que contém o modelo de caixa de diálogo nomeado pelo membro lpPageSetupTemplateName .

lCustData

Tipo: LPARAM

Dados definidos pelo aplicativo que o sistema passa para o procedimento de gancho identificado pelo membro lpfnPageSetupHook . Quando o sistema envia a mensagem WM_INITDIALOG para o procedimento de gancho, o parâmetro lParam da mensagem é um ponteiro para a estrutura PAGESETUPDLG especificada quando a caixa de diálogo foi criada. O procedimento de gancho pode usar esse ponteiro para obter o valor lCustData .

lpfnPageSetupHook

Tipo: LPPAGESETUPHOOK

Um ponteiro para um procedimento de gancho PageSetupHook que pode processar mensagens destinadas à caixa de diálogo. Esse membro é ignorado, a menos que o sinalizador PSD_ENABLEPAGESETUPHOOK seja definido no membro Flags .

lpfnPagePaintHook

Tipo: LPPAGEPAINTHOOK

Um ponteiro para um procedimento de gancho PagePaintHook que recebe mensagens WM_PSD_* da caixa de diálogo sempre que a página de exemplo é redesenhada. Ao processar as mensagens, o procedimento de gancho pode personalizar a aparência da página de exemplo. Esse membro é ignorado, a menos que o sinalizador PSD_ENABLEPAGEPAINTHOOK seja definido no membro Flags .

lpPageSetupTemplateName

Tipo: LPCTSTR

O nome do recurso de modelo da caixa de diálogo no módulo identificado pelo membro hInstance . Esse modelo é substituído pelo modelo da caixa de diálogo padrão. Para recursos da caixa de diálogo numerada, lpPageSetupTemplateName pode ser um valor retornado pela macro MAKEINTRESOURCE . Esse membro é ignorado, a menos que o sinalizador PSD_ENABLEPAGESETUPTEMPLATE seja definido no membro Flags .

hPageSetupTemplate

Tipo: HGLOBAL

Se o sinalizador PSD_ENABLEPAGESETUPTEMPLATEHANDLE estiver definido no membro Flags , hPageSetupTemplate será um identificador para um objeto de memória que contém um modelo de caixa de diálogo.

Comentários

Se os sinalizadores PSD_INHUNDREDTHSOFMILLIMETERS e PSD_INTHOUSANDTHSOFINCHES não forem especificados, o sistema consultará o valor LOCALE_IMEASURE da localidade de 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 o tamanho do papel.

Se hDevNames e hDevMode tiverem identificadores válidos e o nome da impressora especificado pelo membro wDeviceOffset da estrutura DEVNAMES não for o mesmo que o nome especificado pelo membro dmDeviceName da estrutura DEVMODE , o sistema usará o nome especificado por wDeviceOffset por padrão.

Requisitos

Confira também

Biblioteca de caixas de diálogo comuns

Conceitual

DEVMODE

DEVNAMES

MAKEINTRESOURCE

Outros recursos

PagePaintHook

Pagesetupdlg

PageSetupHook

Referência

WM_INITDIALOG