AddRoleMap

PDF برچسب‌دار, دسترس‌پذیری

شرح

این صفحه AddRoleMap را در PDFlibPas و در موضوع PDF برچسب‌دار, دسترس‌پذیری مستند می‌کند. نام‌های API، پارامترها، کلاس‌ها، نام فایل‌ها و مقدارهای لفظی بدون تغییر می‌مانند تا با کتابخانه Delphi و نقاط ورود DLL هماهنگ باشند

پیش از فراخوانی تابع، نحو، پارامترها و مقدارهای بازگشتی را بررسی کنید. بلوک‌های کد در شکل اصلی خود باقی می‌مانند تا نمونه‌ها بدون تغییر قابل کپی باشند.

هنگام استفاده از این API، محدودیت‌های PDF/A، حداقل نسخه لازم PDF، منابع خارجی و وضعیت انتخاب‌شده سند را در نظر بگیرید

پیش از فراخوانی تابع، نحو، پارامترها و مقدارهای بازگشتی را بررسی کنید. بلوک‌های کد در شکل اصلی خود باقی می‌مانند تا نمونه‌ها بدون تغییر قابل کپی باشند. BeginTag, BeginTagEx

پیش از فراخوانی تابع، نحو، پارامترها و مقدارهای بازگشتی را بررسی کنید. بلوک‌های کد در شکل اصلی خود باقی می‌مانند تا نمونه‌ها بدون تغییر قابل کپی باشند.

نحو

Delphi

Function TPDFlib.AddRoleMap(Const CustomType, StandardType: WideString): Integer;

ActiveX

Function PDFlib::AddRoleMap(CustomType As String, StandardType As String) As Long

DLL

int DLAddRoleMap(int InstanceID, const wchar_t * CustomType, const wchar_t * StandardType);

پارامترها

CustomTypeCustomType پارامتری برای AddRoleMap است. نوع نمایش‌داده‌شده در امضا را به کار ببرید و مقداری متناسب با سند PDF فعلی، صفحه انتخاب‌شده یا منبع فعال ارائه کنید. BeginTag, BeginTagEx
StandardTypeStandardType پارامتری برای AddRoleMap است. نوع نمایش‌داده‌شده در امضا را به کار ببرید و مقداری متناسب با سند PDF فعلی، صفحه انتخاب‌شده یا منبع فعال ارائه کنید.

مقادیر بازگشتی

0این مقدار نتیجه AddRoleMap را توضیح می‌دهد. به طور معمول مقدار غیرصفر نشان‌دهنده موفقیت است و 0 یعنی عملیات کامل نشده است
1این مقدار نتیجه AddRoleMap را توضیح می‌دهد. به طور معمول مقدار غیرصفر نشان‌دهنده موفقیت است و 0 یعنی عملیات کامل نشده است

مثال

// Document with custom element types mapped to standard PDF structure types
PDF.SetPDFUAMode('en-US');
PDF.AddRoleMap('Headline', 'H1');
PDF.AddRoleMap('Subheadline', 'H2');
PDF.AddRoleMap('Caption', 'P');

PDF.BeginTag('Headline', '', '');
PDF.PrintText(50, 750, 'Annual Report 2026');
PDF.EndTag;

PDF.BeginTag('Subheadline', '', '');
PDF.PrintText(50, 720, 'Financial Highlights');
PDF.EndTag;