pdfCreateGoToRActionExU
GoToR-to-named-destination variant with a Unicode file name.
| Exported names | pdfCreateGoToRActionExUA, pdfCreateGoToRActionExUW |
|---|
Purpose — GoToR-to-named-destination variant with a Unicode file name.
Description — Identical to pdfCreateGoToRActionEx except FileName is PWideChar in both the A and W exports (the "U" in the name marks the file name as Unicode regardless of suffix); DestName still switches ANSI/UTF-16 by the A/W suffix as usual.
Declarations
int32_t __stdcall pdfCreateGoToRActionExUA(PPDF IPDF, const wchar_t* FileName, const char* DestName, BOOL32 NewWindow);
int32_t __stdcall pdfCreateGoToRActionExUW(PPDF IPDF, const wchar_t* FileName, const wchar_t* DestName, BOOL32 NewWindow);
function pdfCreateGoToRActionExUA(const IPDF: PPDF; const FileName: PWideChar; DestName: PAnsiChar; NewWindow: LongBool): Integer; stdcall; external 'LumasPdf.dll';
function pdfCreateGoToRActionExUW(const IPDF: PPDF; const FileName: PWideChar; DestName: PWideChar; NewWindow: LongBool): Integer; stdcall; external 'LumasPdf.dll';
Parameters
| Parameter | Type | Description |
|---|---|---|
IPDF | PPDF | Instance handle. |
FileName | PWideChar | Target file, UTF-16 in both variants. |
DestName | string | Named destination; ANSI (ExUA) or UTF-16 (ExUW). |
NewWindow | BOOL32 | New-window hint, stored and serialized. |
Return value — 1-based action handle (> 0), or 0 on an invalid handle.
See also — pdfCreateGoToRActionEx
C# (P/Invoke)
public static extern int pdfCreateGoToRActionExUA(IntPtr IPDF, [MarshalAs(UnmanagedType.LPWStr)] string FileName, IntPtr DestName, [MarshalAs(UnmanagedType.Bool)] bool NewWindow);
public static extern int pdfCreateGoToRActionExUW(IntPtr IPDF, [MarshalAs(UnmanagedType.LPWStr)] string FileName, IntPtr DestName, [MarshalAs(UnmanagedType.Bool)] bool NewWindow);
Object Creation
pdfCreateGoToRActionExUA
pdfCreateGoToRActionExUW
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.