Function Reference


_WinAPI_PrintDlgEx

Displays a Print property sheet that enables the user to specify the properties of a particular print job

#include <WinAPIDlg.au3>
_WinAPI_PrintDlgEx ( ByRef $tPRINTDLGEX )

Parameters

$tPRINTDLGEX $tagPRINTDLGEX structure that contains information used to initialize the property sheet. When the
function returns, it contains information about the user's selections. This structure must be
initialized before function call.
(See MSDN for more information)

Return Value

Success: 1, @extended flag will contain one of the following values.
$PD_RESULT_APPLY
$PD_RESULT_CANCEL
$PD_RESULT_PRINT
Failure: 0 and sets the @error flag to non-zero, @extended flag may contain the HRESULT error code.

Remarks

Note that the values of "hDevMode" and "hDevNames" member in $tagPRINTDLGEX may change when they are passed into
_WinAPI_PrintDlgEx(). This is because these members are filled on both input and output.

See Also

Search PrintDlgEx in MSDN Library.

Example

#include <APIDlgConstants.au3>
#include <Memory.au3>
#include <WinAPIDlg.au3>
#include <WinAPIMisc.au3>

Opt('WinTitleMatchMode', 3)

_Example()

Func _Example()
        ; Create PRINTDLGEX structure and set initial values for the number of copies, starting, and ending page
        Local $tPRINTPAGERANGE = DllStructCreate($tagPRINTPAGERANGE)
        DllStructSetData($tPRINTPAGERANGE, 'FromPage', 2)
        DllStructSetData($tPRINTPAGERANGE, 'ToPage', 3)
        Local $tPRINTDLGEX = DllStructCreate($tagPRINTDLGEX)
        DllStructSetData($tPRINTDLGEX, 'Size', DllStructGetSize($tPRINTDLGEX))
        DllStructSetData($tPRINTDLGEX, 'hOwner', WinGetHandle(AutoItWinGetTitle()))
        DllStructSetData($tPRINTDLGEX, 'Flags', BitOR($PD_PAGENUMS, $PD_NOCURRENTPAGE, $PD_NOSELECTION))
        DllStructSetData($tPRINTDLGEX, 'NumPageRanges', 1)
        DllStructSetData($tPRINTDLGEX, 'MaxPageRanges', 1)
        DllStructSetData($tPRINTDLGEX, 'PageRanges', DllStructGetPtr($tPRINTPAGERANGE))
        DllStructSetData($tPRINTDLGEX, 'MinPage', 1)
        DllStructSetData($tPRINTDLGEX, 'MaxPage', 9)
        DllStructSetData($tPRINTDLGEX, 'Copies', 4)
        DllStructSetData($tPRINTDLGEX, 'StartPage', -1)

        ; Display Print property sheet
        If Not _WinAPI_PrintDlgEx($tPRINTDLGEX) Then
                Exit
        EndIf

        Switch @extended
                Case $PD_RESULT_PRINT
                        ; The user clicked the "Print" button
                Case $PD_RESULT_APPLY
                        ; The user clicked the "Apply" button and later clicked the "Cancel" button
                Case $PD_RESULT_CANCEL
                        Exit
        EndSwitch

        ; Show results
        Local $hDevNames = DllStructGetData($tPRINTDLGEX, 'hDevNames')
        Local $pDevNames = _MemGlobalLock($hDevNames)
        Local $tDEVNAMES = DllStructCreate($tagDEVNAMES, $pDevNames)
        ConsoleWrite('Printer: ' & _WinAPI_GetString($pDevNames + 2 * DllStructGetData($tDEVNAMES, 'DeviceOffset')))
        If DllStructGetData($tDEVNAMES, 'Default') Then
                ConsoleWrite(' (Default)' & @CRLF)
        Else
                ConsoleWrite(@CRLF)
        EndIf
        Local $aPage[2]
        If BitAND(DllStructGetData($tPRINTDLGEX, 'Flags'), $PD_PAGENUMS) Then
                $aPage[0] = DllStructGetData($tPRINTPAGERANGE, 'FromPage')
                $aPage[1] = DllStructGetData($tPRINTPAGERANGE, 'ToPage')
        Else
                $aPage[0] = DllStructGetData($tPRINTDLGEX, 'MinPage')
                $aPage[1] = DllStructGetData($tPRINTDLGEX, 'MaxPage')
        EndIf
        ConsoleWrite('First page: ' & $aPage[0] & @CRLF)
        ConsoleWrite('Last page: ' & $aPage[1] & @CRLF)
        ConsoleWrite('Copies: ' & DllStructGetData($tPRINTDLGEX, 'Copies') & @CRLF)

        ; Free global memory objects that contains a DEVMODE and DEVNAMES structures
        _MemGlobalFree(DllStructGetData($tPRINTDLGEX, 'hDevMode'))
        _MemGlobalFree($hDevNames)
EndFunc   ;==>_Example