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 | رنگ پسزمینهٔ فیلد فرم مشخصشده با موفقیت تنظیم شد |