PAGESETUPDLG

Struktura PAGESETUPDLG zawiera informacje, używany przez funkcję PageSetupDlg zainicjować okno dialogowe StronawspólneUstawienia . Po użytkownik zamyka okno dialogowe, system zwraca informacje o parametry zdefiniowane przez użytkownika strony w tej struktury .

element TypeDef struct tagPSD {/ / psd DWORD lStructSize; 
    HWND hwndOwner; 
    HGLOBAL pole hDevMode; 
    HGLOBAL hDevNames; 
    DWORD Znaczników; 
    PKT ptPaperSize; 
    RECT rtMinMargin; 
    RECT rtMargin; 
    Wystąpienie HINSTANCE wystąpienie hInstance; 
    FIKCYJNYMI lCustData; 
    LPPAGESETUPHOOK lpfnPageSetupHook; 
    LPPAGEPAINTHOOK lpfnPagePaintHook; 
    LPCTSTR lpPageSetupTemplateName; 
    HGLOBAL hPageSetupTemplate; 
} PAGESETUPDLG, * LPPAGESETUPDLG 

 

Członkowie

lStructSize
Określa rozmiar, w bajtach, ta struktura.
hwndOwner
Identyfikuje okno, w którym posiada okno dialogowe. Ten element może być dowolny uchwyt okna ważne lub go może być NULL, jeśli okno dialogowe bez właściciela.
pole hDevMode
Dojście do obiektu globalnej pamięci, który zawiera struktury DEVMODE . Na wejściu Jeśli uchwyt, wartości w odpowiedniej struktury DEVMODE są używane do inicjowania formantów w oknie dialogowym. Produkcja, box setów okna dialogowego pole hDevMode uchwyt globalnej pamięci dla struktury DEVMODE , zawierającą wartości określające wybrane przez użytkownika. Jeśli wybrane przez użytkownika nie są dostępne, okno dialogowe ustawia pole hDevMode wartość null.
hDevNames
Dojście do obiektu globalnej pamięci, który zawiera strukturę DEVNAMES. . Struktura ta zawiera trzy ciągi, które określają nazwę sterownika, nazwa drukarki i nazwa portu wyjściowego. Na wejściu Jeśli uchwyt, ciągi w odpowiedniej struktury DEVNAMES są używane do inicjowania formantów w oknie dialogowym. Produkcja, box setów okno dialogowe hDevNames uchwyt globalnej pamięci dla struktury DEVNAMES , zawierającą ciągi określające wybrane przez użytkownika. Jeśli wybrane przez użytkownika nie są dostępne, okno dialogowe ustawia hDevNames wartość null.
Flagi
Zestaw flag bitowych, które można zainicjować okno dialogowe StronawspólneUstawienia . Gdy okno dialogowe zwraca, ustawia te flagi, aby wskazać dane wejściowe użytkownika. Ten element może być kombinacją następujących flag :
PSD_DEFAULTMINMARGINS
Ustawia wartości minimalnej, które użytkownicy będą mogli określić dla marginesów strony za minimalnymi marginesami dozwolone przez drukarkę. Jest to ustawienie domyślne. Ta flaga jest ignorowane, jeśli określono też flagi PSD_MARGINS i PSD_MINMARGINS.
PSD_DISABLEMARGINS
Wyłącza marginesów, uniemożliwia użytkownikowi ustawianie marginesów.
PSD_DISABLEORIENTATION
Wyłączenie formantów orientację, uniemożliwia użytkownikowi ustawienia orientacji strony.
PSD_DISABLEPAGEPAINTING
Okno dialogowe uniemożliwia rysunku zawartość strony próbki. Jeśli włączysz procedura haka PagePaintHook , nadal można narysować zawartość przykładowa strona.
PSD_DISABLEPAPER
Wyłączenie formantów papieru, uniemożliwia użytkownikowi ustawianie parametrów strony, takich jak rozmiar papieru i źródła.
PSD_DISABLEPRINTER
Wyłącza przycisk drukarki , zapobiegając uruchamianiu pojawia się okno dialogowe zawierający informacje dotyczące instalatora dodatkowego drukarki użytkownika.
PSD_ENABLEPAGEPAINTHOOK
Umożliwia procedura haka określonego członka lpfnPagePaintHook.
PSD_ENABLEPAGESETUPHOOK
Umożliwia procedura haka określonego członka lpfnPageSetupHook.
PSD_ENABLEPAGESETUPTEMPLATE
Wskazuje, że wystąpienie hInstance i lpPageSetupTemplateName członków określić szablon pole dialogowe używać zamiast domyślnego szablonu.
PSD_ENABLEPAGESETUPTEMPLATEHANDLE
Wskazuje, że element hPageSetupTemplate identyfikuje bloku danych, zawierający szablon pole dialogowe wstępnie. System ignoruje Państwa lpPageSetupTemplateName , jeśli ta flaga jest określona.
PSD_INHUNDREDTHSOFMILLIMETERS
Wskazuje, że setnych milimetry są jednostki miary dla marginesów i rozmiar papieru. Wartości w polu Członkowie rtMargin, rtMinMargini ptPaperSize są w setnych częściach milimetry. Ta flaga można ustawić na dane wejściowe do zastąpić domyślną jednostkę miary dla regionalnych użytkownika. Gdy funkcja zwraca, ustawia pole dialogowe używane tej flagi do wskazania jednostki.
PSD_INTHOUSANDTHSOFINCHES
Wskazuje, że tysięcznych cale są jednostki miary dla marginesów i rozmiar papieru. Wartości członków rtMargin, rtMinMargini ptPaperSize są w tysięcznych cali. Ta flaga można ustawić na dane wejściowe do zastąpić domyślną jednostkę miary dla regionalnych użytkownika. Gdy funkcja zwraca, ustawia pole dialogowe używane tej flagi do wskazania jednostki.
PSD_INWININIINTLMEASURE
Nie wdrożono.
PSD_MARGINS
Powoduje, że system, aby używać wartości określone w Państwa rtMargin pierwotnej szerokości do lewej, górnej, prawo i dolnego marginesu. Jeśli PSD_MARGINS nie jest ustawiony, system ustawia pierwotnej szerokości na jeden cal dla wszystkich marginesów.
PSD_MINMARGINS
Powoduje, że system, aby używać wartości określonych w Państwa rtMinMargin jako minimalnej szerokości dopuszczalne dla lewej, górnej, prawo i dolnego marginesu. System uniemożliwia użytkownikowi wprowadzanie szerokości, która jest mniejsza niż określone minimum. Jeśli PSD_MINMARGINS nie jest określony, system Ustawia minimalną szerokość dopuszczalne do tych, które są dozwolone przez drukarkę.
PSD_NONETWORKBUTTON
Ukrywa i wyłącza przycisk sieć.
PSD_NOWARNING
Uniemożliwia wyświetlanie komunikat ostrzegawczy, kiedy istnieje nie domyślnej drukarki systemu.
PSD_RETURNDEFAULT
PageSetupDlg nie wyświetla okno dialogowe. Zamiast tego, ustawia członków hDevNames i pole hDevMode dla dojścia do struktury DEVMODE i DEVNAMES , które są inicjowane drukarki domyślnej systemu. PageSetupDlg zwraca błąd, jeśli hDevNames lub pole hDevMode nie ma wartości NULL.
PSD_SHOWHELP
Powoduje, że okno dialogowe wyświetlić przycisk Pomoc . Państwa hwndOwner należy określić, że okno, aby otrzymać HELPMSGSTRING zarejestrowane komunikaty, które okna dialogowego wysyła wówczas, gdy użytkownik kliknie przycisk Pomoc.

ptPaperSize
Pozwala określić wymiary papieru wybranej przez użytkownika. Flaga PSD_INTHOUSANDTHSOFINCHES lub PSD_INHUNDREDTHSOFMILLIMETERS wskazuje jednostek miar.
rtMinMargin
Określa minimalny dopuszczalny szerokości do lewej, górnej, prawo i dolnego marginesu. System zignoruje ten element członkowski, jeśli nie jest ustawiona flaga PSD_MINMARGINS. Te wartości muszą być mniejsza lub równa wartości określonej w elemencie rtMargin . Flaga PSD_INTHOUSANDTHSOFINCHES lub PSD_INHUNDREDTHSOFMILLIMETERS wskazuje jednostek miar.
rtMargin
Określa szerokość lewego, góry, prawo i dolnego marginesu. Jeśli zostanie ustawiona flaga PSD_MARGINS, rtMargin określa wartości Początkowy depozyt. Gdy PageSetupDlg zwraca, rtMargin zawiera szerokość marginesów, wybraną przez użytkownika. Flaga PSD_INHUNDREDTHSOFMILLIMETERS lub PSD_INTHOUSANDTHSOFINCHES wskazuje jednostek miar.
wystąpienie hInstance
Jeżeli w Państwa flagi jest ustawiona flaga PSD_ENABLEPAGESETUPTEMPLATE, wystąpienie hInstance to dojście aplikacji lub wystąpienia modułu, zawierający szablon pole dialogowe o nazwie przez członka lpPageSetupTemplateName.
lCustData
Określa dane zdefiniowane przez aplikację, że system przechodzi do procedura haka zidentyfikowane przez członka lpfnPageSetupHook . Gdy system wysyła komunikat WM_INITDIALOG procedura haka, wiadomości fikcyjnymi parametr jest wskaźnik do struktury PAGESETUPDLG określone podczas tworzenia okna dialogowego. Procedura haka można użyć tego wskaźnika aby uzyskać wartość lCustData.
lpfnPageSetupHook
Wskaźnik PageSetupHook spinanie procedury, który może przetwarzać wiadomości przeznaczonych dla okna dialogowego. Członek ten jest ignorowany, chyba że członek flagi jest ustawiona flaga PSD_ENABLEPAGESETUPHOOK.
lpfnPagePaintHook
Wskaźnik PagePaintHook spinanie procedury, który odbiera WM_PSD_ * wiadomości z okna dialogowego, ilekroć przykładowa strona jest odświeżana. Przetwarzanie wiadomości, procedura haka można dostosować wygląd strony próbki. Członek ten jest ignorowany, chyba że członek flagi jest ustawiona flaga PSD_ENABLEPAGEPAINTHOOK.
lpPageSetupTemplateName
Wskaźnik ciąg zakończony znakiem null, nazwy zasobu szablonu pole dialogowe w module zidentyfikowane przez członka wystąpienie hInstance . Ten szablon jest podstawiane szablonu pole standardowe okno dialogowe. Zasobów pole dialogowe numerowane lpPageSetupTemplateName może być wartość zwracany przez makro MAKEINTRESOURCE . Członek ten jest ignorowany, chyba że członek flagi jest ustawiona flaga PSD_ENABLEPAGESETUPTEMPLATE.
hPageSetupTemplate
Jeżeli w Państwa flagi jest ustawiona flaga PSD_ENABLEPAGESETUPTEMPLATEHANDLE, hPageSetupTemplate to dojście obiektu pamięci zawierającego szablon pole dialogowe.

Uwagi

Jeśli nie określono flagi PSD_INHUNDREDTHSOFMILLIMETERS i PSD_INTHOUSANDTHSOFINCHES, system kwerendy wartości LOCALE_IMEASURE ustawienia regionalne użytkownika domyślnego, aby określić jednostkę miary (setnych milimetry) albo tysięcznych cale szerokości marginesów i rozmiar papieru.

Jeśli zarówno hDevNames , jak i pole hDevMode ma nieprawidłowy uchwytów i nazwa drukarki określone przez członka wDeviceOffset struktury DEVNAMES jest nie taka sama, jak nazwa określona przez członka dmDeviceName struktury DEVMODE , system używa nazwy określonej przez wDeviceOffset domyślnie.

Skrócone informacje

nbsp; Windows &NT: wymaga wersji 3.51 lub nowszych.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w commdlg.h.
Unicode:Zdefiniowane jako struktur Unicode i ANSI.

Zobacz też

Wspólny omówienie biblioteki okna dialogowego, wspólnych struktur pole dialogowe, DEVMODE, DEVNAMES., MAKEINTRESOURCE, PagePaintHook, PageSetupDlg, PageSetupHook, WM_INITDIALOG

Index