پرسش‌های متداول

پاسخ‌های کاربردی به مشکلاتی که کاربران HotXLS در ابتدا با آن‌ها مواجه می‌شوند

این صفحه پرسش‌هایی را جمع‌آوری می‌کند که به احتمال زیاد هنگام نصب HotXLS، انتخاب بین نماهای XLS و XLSX، ارزیابی نسخه آزمایشی، خروجی گرفتن گزارش‌ها و پیاده‌سازی برنامه‌های Delphi یا C++Builder پیش می‌آیند

کتابخانه بومی کارپوشه‌ها در داخل فرآیند Delphi یا C++Builder شما ایجاد می‌شوند
XLS و XLSX نماهای جداگانه باعث می‌شوند کد XLS قدیمی پایدار بماند، در حالی که XLSX به طور مستقل توسعه می‌یابد
ابتدا نصب‌کننده برای راه‌اندازی عادی از نصب‌کننده استفاده کنید؛ این ابزار نسخه‌های پشتیبانی‌شده RAD Studio را شناسایی می‌کند
بدون حق امتیاز زمان اجرا برنامه‌ها را بدون هزینه‌های زمان اجرا برای هر نسخه، منتشر کنید

نصب و تنظیمات IDE

بیشتر پرسش‌های راه‌اندازی درباره تشخیص IDE، نسخه‌های پشتیبانی‌شده و محتوای اختیاری C++Builder هستند

کدام نسخه‌های Delphi و C++Builder پشتیبانی می‌شوند؟

پکیج کامل، Delphi و C++Builder را از XE5 تا RAD Studio 13.1 Florence هدف قرار می‌دهد؛ نصب‌کننده نسخه آزمایشی در حال حاضر پکیج‌هایی را برای RAD Studio 11.3، 12.3 و 13.1 ارائه می‌دهد

چرا نصب‌کننده تنها برخی از نسخه‌های IDE را فهرست می‌کند؟

صفحه IDE نصب‌های پشتیبانی‌شده RAD Studio را که در دستگاه فعلی شناسایی شده‌اند، فهرست می‌کند؛ اگر یک IDE پشتیبانی‌شده در فهرست نیست، تأیید کنید که RAD Studio نصب شده است و نصب‌کننده تحت همان نمایه کاربری Windows در حال اجراست که تنظیمات IDE متعلق به آن است

اجزای زمان طراحی کجا ظاهر می‌شوند؟

نصب‌کننده یک برگه Tool Palette به نام losLab ثبت می‌کند؛ اجزای بصری شامل DataToXLS و GridToXLS هستند

چرا پکیج‌ها یا دموهای C++Builder پس از نصب وجود ندارند؟

فایل‌های پکیج و پروژه‌های دموی C++Builder محتوای اختیاری نصب‌کننده هستند؛ در صورت نیاز به یکپارچه‌سازی یا دموهای C++Builder، کادر C++Builder مربوط به IDE را در طول نصب انتخاب کنید

آیا از Win32 و Win64 پشتیبانی می‌شود؟

بله، HotXLS خروجی‌های استاندارد پکیج Win32 و Win64 را برای نسخه‌های پشتیبانی‌شده IDE ارائه می‌دهد؛ نصب‌کننده ممکن است مسیرهای کتابخانه Win64x را برای بازسازی سورس ثبت کند، اما پکیج‌های پیش‌ساخته Win64x در حال حاضر ارائه نمی‌شوند

آیا باید Microsoft Excel را نصب کرده باشم؟

خیر، HotXLS مستقیماً کارپوشه‌ها را می‌خواند، می‌نویسد، استایل‌دهی می‌کند و خروجی می‌گیرد؛ به Microsoft Excel، اتوماسیون Office، اتوماسیون COM یا یک فرآیند صفحه‌گسترده خارجی نیازی ندارد

نسخه آزمایشی

نسخه آزمایشی از نظر API با نسخه کامل سازگار است، اما محدودیت‌های پنهانی برای اندازه کارپوشه دارد

نسخه آزمایشی چه محدودیت‌هایی را اعمال می‌کند؟

در هر کارپوشه، نسخه آزمایشی تا ۵ کاربرگ، ۱۰۰ سطر در هر کاربرگ و ۲۶ ستون در هر کاربرگ را مجاز می‌داند؛ همین محدودیت‌ها برای نمای XLS و نمای XLSX اعمال می‌شوند

چرا خروجی نسخه آزمایشی من پس از ستون Z یا سطر ۱۰۰ متوقف می‌شود؟

نوشتن فراتر از محدودیت‌های نسخه آزمایشی توسط API پذیرفته می‌شود اما از فایل ذخیره‌شده حذف می‌گردد؛ نسخه کامل این محدودیت‌ها را بدون نیاز به تغییر در سورس کد برطرف می‌کند

آیا نسخه آزمایشی فایل‌هایی را که باز می‌کنم کوتاه می‌کند؟

خیر، باز کردن یک کارپوشه موجود با بیش از ۵ کاربرگ یا بیش از ۱۰۰ سطر و ۲۶ ستون، فایل را کوتاه نمی‌کند؛ محدودیت‌ها برای افزودن کاربرگ توسط کاربر و نوشتن در سلول‌ها پس از ایجاد کارپوشه اعمال می‌شوند

آیا در نسخه آزمایشی با رسیدن به محدودیت هشداری نمایش داده می‌شود؟

خیر، محدودیت‌ها بی‌صدا هستند: هیچ کادر گفتگو، خط ثبت وقایع یا استثنایی هنگام نوشتن فراتر از محدودیت نسخه آزمایشی صادر نمی‌شود

انتخاب API

HotXLS رابط‌های کلاسیک XLS و مدرن XLSX را مجزا نگه می‌دارد تا پروژه‌های موجود بتوانند با سرعت خودشان پیش بروند

آیا باید از lxHandle استفاده کنم یا lxHandleX؟

از lxHandle برای جریان‌های کاری کلاسیک Excel 97-2003 XLS و کد گزارش قدیمی استفاده کنید؛ از lxHandleX و TXLSXWorkbook برای فایل‌های Excel 2007+ XLSX و ویژگی‌های خاص OOXML استفاده کنید

آیا یک پروژه می‌تواند از هر دو نما استفاده کند؟

بله، برنامه‌ها می‌توانند شامل هر دو یونیت باشند و اشیاء کارپوشه جداگانه‌ای را برای هر فرمت فایل نگه دارند؛ این امر هنگام حفظ خروجی XLS قدیمی و افزودن گزارش‌های جدید XLSX مفید است

چرا برخی از ویژگی‌های XLSX از طریق API قدیمی XLS در دسترس نیستند؟

XLS و XLSX مدل‌های فایل متفاوتی دارند؛ مفاهیم مختص XLSX مانند رشته‌های اشتراکی، استایل‌های OOXML، جداول، برگه‌های نمودار و روابط پکیج در lxHandleX قرار دارند و به نمای کلاسیک XLS افزوده نمی‌شوند

با کدام نمونه کد باید شروع کنم؟

با دموهای QuickStart و ApiTour در پوشه‌های دموی Delphi یا C++Builder شروع کنید؛ برای کد خاص XLSX، از نمای کلی رابط XLSX و دموهای خروجی XLSX استفاده کنید

ویژگی‌ها و محدودیت‌های XLSX

نمای XLSX نیازهای رایج تولید گزارش را پوشش می‌دهد و ویژگی‌هایی را که عمداً رزرو شده‌اند مستند می‌کند

کدام ویژگی‌های XLSX پشتیبانی می‌شوند؟

TXLSXWorkbook از مقادیر، فرمول‌ها، محاسبه صریح فرمول، استایل‌ها، فرمت‌های سفارشی اعداد، عرض و ارتفاع، سلول‌های ادغام‌شده، خروجی HTML در سطح محدوده، لینک‌ها، نظرات، تصاویر، قالب‌بندی شرطی، اعتبارسنجی داده‌ها، فیلترها، جداول، نمودارها، متن غنی، مشخصات سند، قابلیت مشاهده برگه، تنظیمات صفحه، ذخیره رمزگذاری‌شده با AES و باز کردن/ذخیره مبتنی بر جریان (stream) پشتیبانی می‌کند

آیا می‌توانم فایل‌های XLSX را از جریان‌ها ذخیره یا باز کنم؟

بله، نمای XLSX از SaveAs(Stream) و Open(Stream) پشتیبانی می‌کند که برای بافرهای حافظه، فیلدهای BLOB پایگاه داده، پاسخ‌های HTTP و سایر مسیرهای ذخیره‌سازی غیر فایلی مناسب هستند

چگونه باید با خروجی‌های بزرگ XLSX برخورد کرد؟

از نمای XLSX استفاده کنید و زمانی که گزارش برگه به برگه تولید می‌شود، Workbook.StreamingWrite را فعال کنید؛ نوشتن جریانی فشار حافظه کارپوشه را هنگام ذخیره کاهش می‌دهد

آیا HotXLS می‌تواند آرشیوهای XLSX رمزگذاری‌شده با رمز عبور را باز یا ذخیره کند؟

متد TXLSXWorkbook.SaveAsEncrypted می‌تواند در صورت ارائه رمز عبور غیر خالی، یک محفظه XLSX محافظت‌شده با ECMA-376 AES بنویسد؛ OpenEncrypted می‌تواند برای پکیج‌های رمزنگاری‌نشده به Open معمولی بازگردد، اما تا زمانی که پشتیبانی از رمزگشایی اضافه نشود، همچنان خطای EXlsxEncryptionNotImplemented را برای پکیج‌های رمزگذاری‌شده ایجاد می‌کند؛ محافظت از کاربرگ و کارپوشه ویژگی‌های قفل‌گذاری مجزا به سبک Excel باقی می‌مانند

آیا می‌توانم ماکروها را حفظ کنم؟

نمای XLSX می‌تواند یک بارگذاری vbaProject.bin را بایت به بایت در سراسر کارپوشه نگه دارد و یک نمای تجزیه‌شده و فقط خواندنی از ParsedVBAProject را برای ذخیره‌سازی معتبر VBA در معرض دید قرار دهد؛ این ابزار کد VBA را کامپایل یا اجرا نمی‌کند

آیا فرمول‌ها در داخل HotXLS محاسبه می‌شوند؟

ابزار HotXLS متن فرمول را در کارپوشه‌های ذخیره‌شده می‌نویسد و برنامه‌های صفحه‌گسترده می‌توانند آن سلول‌ها را هنگام باز شدن فایل دوباره محاسبه کنند؛ برای ارزیابی صریح در حین پردازش، هر دو نمای کلاسیک XLS و XLSX از متد Calculate پشتیبانی می‌کنند؛ زمانی که توابع سفارشی یا پشتیبانی‌نشده کاربرگ باید توسط کد برنامه مدیریت شوند، OnUserFunction را اختصاص دهید

خروجی گرفتن، استقرار و مجوزها

این پاسخ‌ها فرمت‌های خروجی، انتظارات استقرار و پرسش‌های مربوط به مجوز را که معمولاً قبل از انتشار یک برنامه پرسیده می‌شوند، پوشش می‌دهند

آیا HotXLS می‌تواند با فرمت‌هایی غیر از XLS یا XLSX خروجی بگیرد؟

بله، HotXLS شامل ابزارهای کمکی خروجی برای فرمت‌هایی مانند CSV، TSV، HTML و RTF است؛ از نمایی که با فرمت کارپوشه شما مطابقت دارد استفاده کنید و روش خروجی مورد نیاز جریان کاری خود را برگزینید

آیا می‌توانم از HotXLS در سرویس‌ها یا ابزارهای دسته‌ای استفاده کنم؟

بله، از آنجایی که HotXLS اکسل را خودکار نمی‌کند، برای برنامه‌های دسکتاپ، سرویس‌ها، کارهای دسته‌ای، نصب‌کننده‌ها و ابزارهای سمت سرور که اتوماسیون Office ممکن است شکننده یا در دسترس نباشد، مناسب است

آیا هزینه‌های حق امتیاز زمان اجرا وجود دارد؟

خیر، HotXLS نیازی به حق امتیاز زمان اجرا ندارد؛ شما برای توسعه‌دهندگانی که با این کتابخانه برنامه می‌سازند به مجوز توسعه‌دهنده نیاز دارید