SetFormFieldBackgroundColorSepA

فیلدهای فرم، رنگ

توضیحات

حرف پایانی A نقطهٔ ورود DLL یعنی ANSI (char) را نشان می‌دهد؛ سطح ActiveX/COM تنها فرم یونیکد را افشا می‌کند. رفتار با SetFormFieldBackgroundColorSep یکسان است و آرگومان‌های رشته‌ای با code page فعلیِ SetAnsiMode تفسیر می‌شوند

رنگ پس‌زمینهٔ فیلد فرم مشخص‌شده را تنظیم می‌کند؛ شبیه تابع SetFormFieldBorderColor است، اما از ته‌رنگی از رنگ جداسازی که با تابع AddSeparationColor اضافه شده استفاده می‌کند. مشخصات PDF فضاهای رنگ جداسازی را برای فیلدهای فرم پشتیبانی نمی‌کند، پس نتیجه همیشه کار نمی‌کند، مخصوصاً اگر فیلد فرم بعداً در Acrobat ویرایش شود. این قابلیت برای موقعیت‌هایی اضافه شده که فیلد فرم مسطح‌سازی خواهد شد

نحو

Delphi

Function DLSetFormFieldBackgroundColorSepA(InstanceID, Index: Integer; ColorName: PAnsiChar; Tint: Double): Integer;

DLL

int DLSetFormFieldBackgroundColorSepA(int InstanceID, int Index, const char * ColorName, double Tint);

پارامترها

Indexشاخص فیلد فرم
ColorNameنام رنگ جداسازی که با تابع AddSeparationColor استفاده شده است
Tintمقدار رنگ مورد استفاده؛ 0 یعنی بدون رنگ (سفید) و 1 یعنی بیشینهٔ رنگ

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

0فیلد فرم یافت نشد یا نام رنگ جداسازی یافت نشد
1رنگ پس‌زمینهٔ فیلد فرم مشخص‌شده با موفقیت تنظیم شد