Contents

# LibreOffice ক্যালকে প্রোগ্রাম করার জন্য অ্যাড-ইন

এড-ইন দ্বারা Calc প্রসারিত করার প্রক্রিয়া যা নিম্নে বিবৃত হয়েছে তা পুরনো হয়। ইন্টারফেইসটি এখনও কার্যকর এবং সমর্থিত, বিদ্যমান এড-ইন দ্বারা উপযুক্ততা নিশ্চিতকরণের জন্য, কিন্তু এড-ইন প্রোগ্রাম করার জন্য আপনার উচিত নতুন API ফাংশন ব্যবহার করা।

LibreOffice Calc can be expanded by Add-Ins, which are external programming modules providing additional functions for working with spreadsheets. These are listed in the Function Wizard in the Add-In category. If you would like to program an Add-In yourself, you can learn here which functions must be exported by the shared libraryexternal DLL so that the Add-In can be successfully attached.

LibreOffice searches the Add-in folder defined in the configuration for a suitable shared libraryDLL. To be recognized by LibreOffice, the shared libraryDLL must have certain properties, as explained in the following. This information allows you to program your own Add-In for Function Wizard of LibreOffice Calc.

## অ্যাড-ইন ধারনা

প্রতিটি এড-ইন লাইব্রেরী বিভিন্ন ফাংশন জোগান দেয়। কিছু ফাংশন প্রশাসনিক উদ্দেশ্যের জন্য ব্যবহৃত হয়। আপনার নিজস্ব ফাংশনের জন্য আপনি যেকোনো নাম পছন্দ করতে পারেন। যদিও, প্যারামিটার অতিক্রম সম্পর্কিত নির্দিষ্ট নিয়ম তাদের অনুসরণ করতে হবে। ভিন্ন প্ল্যাটফর্মের জন্য সঠিক নামকরণ এবং কল করার প্রথা ভিন্ন হয়।

### Functions of Shared LibraryAddIn DLL

একটি ন্যুনতমতে, প্রশাসনিক ফাংশনটি GetFunctionCount এবং GetFunctionData অশ্যই থাকতে হবে। এইগুলি ব্যবহার করে, ফাংশনটি প্যারামিটার টাইপ এবং ফলাফল মান ও নির্ধারণ করা যাবে। ফলাফল মান হিসেবে, ডাবল এবং স্ট্রিং টাইপ সমর্থিত হয়। প্যারামিটার হিসেবে, অতিরিক্ত হিসেবে ঘর এলাকা ডাবল বিন্যাস, স্ট্রিং বিন্যাস, এবং ঘর বিন্যাস সমর্থিত হয়।

প্যারামিটার reference ব্যবহার করে অতিক্রান্ত হয়। ফলে, এই মানের একটি পরিবর্তন ভিত্তিপূর্ণভাবে সম্ভব। যদিও, এইটি LibreOffice Calc তে সমর্থিত নয় কারণ এইটি স্প্রেডশীটের মধ্যে কোন অর্থ তৈরি করে না।

লাইব্রেরী রানটাইমের সময় রিলোড করা যাবে এবং প্রশাসনিক ফাংশন দ্বারা তাদের উপাদান বিশ্লেষন করা যায়। প্রতিটি ফাংশনের জন্য,count এবং type প্যারামিটার, অভ্যন্তরীণ এবং বাহ্যিক ফাংশন নাম এবং একটি প্রশাসনিক ক্রম বিষয়ক তথ্য প্রাপ্তিসাধ্য হয়।

ফাংশনগুলো একই সময়ে কল করা হয় এবং তাদের ফলাফল তাৎ‍ক্ষণিকভাবে প্রদান করা হয়। প্রকৃত সময়ের ফাংশনগুলোও (অসমকালীন ফাংশন) সম্ভব; তবে, তাদের জটিলতার কারণে তাদেরকে বিস্তারিত ব্যাখ্যা করা হয় না।

## ইন্টারফেস সম্পর্কিত সাধারণ তথ্য

LibreOffice ক্যালকে সংযোজিত অ্যাড-ইন ফাংশনের সর্বোচ্চ প্যারামিটার সংখ্যা হলো ১৬: প্রদান মান একটি এবং ফাংশনের ইনপুট প্যারামিটার সর্বোচচ ১৫টি।

ডাটার ধরন নিম্নরূপে নির্ধারণ করা হয়:

ডাটার ধরন | সংজ্ঞা
--- | ---
CALLTYPE | উইন্ডোজের অন্তর্ভুক্ত: FAR PASCAL (_far _pascal) অন্যান্য: ডিফল্ট (অপারেটিং সিস্টেম উল্লেখিত ডিফল্ট)
USHORT | ২ বাইট unsigned Integer
DOUBLE | ৮ বাইট প্ল্যাটফর্ম-নির্ভরশীল ফরম্যাট
Paramtype | প্ল্যাটফর্ম-নির্ভরশীল- যেমন int PTR_DOUBLE =0, double এর পয়েন্টার PTR_STRING =1, zero-terminated string এর পয়েন্টার PTR_DOUBLE_ARR =2, double array এর পয়েন্টার PTR_STRING_ARR =3, string array এর পয়েন্টার PTR_CELL_ARR =4, cell array এর পয়েন্টার NONE =5

## Shared LibraryDLL functions

Following you will find a description of those functions, which are called at the Shared Libraryexternal DLL.

For all Shared LibraryDLL functions, the following applies:

void CALLTYPE fn(out, in1, in2, ...)

Output: Resulting value

Input: Any number of types (double&, char*, double*, char**, Cell area), where the Cell area is an array of types double array, string array, or cell array.

### GetFunctionCount()

রেফারেন্স প্যারামিটারের ব্যবস্থাপনা ফাংশন ব্যতীত ফাংশন সংখ্যা প্রদান করে। প্রতিটি ফাংশনের ০ এবং nCount-1 এর মধ্যবর্তী একটি অনন্য সংখ্যা রয়েছে। এই সংখ্যাটি পরবর্তীতে GetFunctionData এবং GetParameterDescription ফাংশনের জন্য প্রয়োজন হবে।

সিনট্যাক্স

void CALLTYPE GetFunctionCount(USHORT& nCount)

প্যারামিটার

USHORT &nCount:

Output: Reference to a variable, which is supposed to contain the number of Add-In functions. For example: If the Add-In provides 5 functions for LibreOffice Calc, then nCount=5.

### GetFunctionData()

একটি অ্যাড-ইন ফাংশন সম্পর্কিত সকল গুরুত্বপূর্ণ তথ্য নির্ধারণ করে।

সিনট্যাক্স

void CALLTYPE GetFunctionData(USHORT& nNo, char* pFuncName, USHORT& nParamCount, Paramtype* peType, char* pInternalName)

প্যারামিটার

USHORT& nNo:

Input: Function number between 0 and nCount-1, inclusively.

char* pFuncName:

Output: Function name as seen by the programmer, as it is named in the Shared LibraryDLL. This name does not determine the name used in the Function Wizard.

USHORT& nParamCount:

Output: Number of parameters in AddIn function. This number must be greater than 0, because there is always a result value; the maximum value is 16.

Paramtype* peType:

Output: Pointer to an array of exactly 16 variables of type Paramtype. The first nParamCount entries are filled with the suitable type of parameter.

char* pInternalName:

Output: Function name as seen by the user, as it appears in the Function Wizard. May contain umlauts.

pFuncName এবং pInternalName প্যারামিটার হলো char অ্যারে, যেগুলো LibreOffice ক্যালকে ২৫৬ আকার বিশিষ্ট।

### GetParameterDescription()

অ্যাড-ইন ফাংশন এবং এর প্যারামিটারের একটি সংক্ষিপ্ত বর্ণনা প্রদান করে। অপশন হিসেবে, এই ফাংশনটি ফাংশন উইজার্ড এর ফাংশন এবং প্যারামিটারের বর্ণনা প্রদর্শন করতে ব্যবহৃত হতে পারে।

সিনট্যাক্স

void CALLTYPE GetParameterDescription(USHORT& nNo, USHORT& nParam, char* pName, char* pDesc)

প্যারামিটার

USHORT& nNo:

Input: Number of the function in the library; between 0 and nCount-1.

USHORT& nParam:

Input: Indicates, for which parameter the description is provided; parameters start at 1. If nParam is 0, the description itself is supposed to be provided in pDesc; in this case, pName does not have any meaning.

char* pName:

Output: Takes up the parameter name or type, for example, the word "Number" or "String" or "Date", and so on. Implemented in LibreOffice Calc as char[256].

char* pDesc:

Output: Takes up the description of the parameter, for example, "Value, at which the universe is to be calculated." Implemented in LibreOffice Calc as char[256].

pName এবং pDesc হলো char অ্যারে; LibreOffice ক্যালকে ২৫৬ আকারে বাস্তবায়িত। অনুগ্রহ করে নোট রাখুন যে ফাংশন উইজার্ড এ বিদ্যমান ফাঁকা স্থান সীমিত এবং ২৫৬টি অক্ষর সম্পূর্ণভাবে ব্যবহার করা যায় না।

## ঘরের এলাকা

ঘরের এলাকা পাস করতে একটি বহিঃস্থ প্রোগ্রাম মডিউল দ্বারা কোন ডাটা স্ট্রাকচার অবশ্যই প্রদান করতে হবে, নিম্নের টেবিলে সে সম্পর্কিত তথ্য রয়েছে। LibreOffice ক্যালক ডাটা ধরনের উপর ভিত্তি করে, তিনটি ভিন্ন অ্যারের মধ্যে পার্থক্য তৈরি করে।

### ডবল অ্যারে

একটি প্যারামিটার হিসেবে, সংখ্যা/ডবল ধরনের মান যুক্ত ঘরের এলাকা পাস করা হয়। LibreOffice ক্যালকে ডবল অ্যারে নিম্নরূপে নির্ধারণ করা হয়:

Offset | Name | Description
--- | --- | ---
0 | কলাম-১ | ঘরের এলাকার উপর-বাম কোনায় কলাম নম্বর। সংখ্যায়ন ০ হতে শুরু হয়।
2 | সারি-১ | ঘরের এলাকার উপর-বাম কোনায় সারি নম্বর; সংখ্যায়ন ০ হতে শুরু হয়।
4 | ট্যাব-১ | ঘরের উপরে-বাম কোণে টেবিল নাম্বার; সংখ্যায়ন ০ থেকে শুরু।
6 | কলাম-২ | ঘরের এলাকার নিচের-ডান কোনায় কলাম নম্বর। সংখ্যায়ন ০ হতে শুরু হয়।
8 | সারি-২ | ঘরের এলাকার নিচের-ডান কোনায় সারি নম্বর; সংখ্যায়ন ০ হতে শুরু হয়।
10 | ট্যাব-২ | ঘরের এলাকার নিচের-ডান কোনায় টেবিল নম্বর; সংখ্যায়ন ০ হতে শুরু হয়।
12 | গণনা | নিম্নের উপাদান সংখ্যা। ফাঁকা ঘর গণনা করা হয় না বা পাস করা হয় না।
14 | কলাম | উপাদানের কলাম সংখ্যা। সংখ্যায়ন ০ হতে শুরু হয়।
16 | সারি | উপাদানের সারি সংখ্যা; সংখ্যায়ন ০ হতে শুরু হয়।
18 | ট্যাব | উপাদানের টেবিল সংখ্যা; সংখ্যায়ন ০ হতে শুরু হয়।
20 | ত্রুটি | ত্রুটি সংখ্যা, যেখানে মান ০ "ত্রুটিহীন" হিসেবে নির্ধারিত। যদি উপাদানটি একটি সূত্র ঘর থেকে আসে, সূত্র দ্বারা ত্রুটি মান নির্ধারণ করা হয়।
22 | মান | ডবল/ফ্লোটিং পয়েন্টের ৮ বাইট IEEE ভেরিয়েবল
30 | ... | পরবর্তী উপাদান

### স্ট্রিং অ্যারে

একটি ঘরের এলাকা, যেটি ডাটার ধরন- টেক্সটের মান ধারণ করে এবং স্ট্রিং অ্যারে হিসেবে পাস করা হয়। LibreOffice ক্যালকের স্ট্রিং অ্যারে নিম্নরূপে নির্ধারণ করা হয়:

Offset | Name | Description
--- | --- | ---
0 | কলাম-১ | ঘরের এলাকার উপর-বাম কোনায় কলাম নম্বর। সংখ্যায়ন ০ হতে শুরু হয়।
2 | সারি-১ | ঘরের এলাকার উপর-বাম কোনায় সারি নম্বর; সংখ্যায়ন ০ হতে শুরু হয়।
4 | ট্যাব-১ | ঘরের উপরে-বাম কোণে টেবিল নাম্বার; সংখ্যায়ন ০ থেকে শুরু।
6 | কলাম-২ | ঘরের এলাকার নিচের-ডান কোনায় কলাম নম্বর। সংখ্যায়ন ০ হতে শুরু হয়।
8 | সারি-২ | ঘরের এলাকার নিচের-ডান কোনায় সারি নম্বর; সংখ্যায়ন ০ হতে শুরু হয়।
10 | ট্যাব-২ | ঘরের এলাকার নিচের-ডান কোনায় টেবিল নম্বর; সংখ্যায়ন ০ হতে শুরু হয়।
12 | গণনা | নিম্নের উপাদান সংখ্যা। ফাঁকা ঘর গণনা করা হয় না বা পাস করা হয় না।
14 | কলাম | উপাদানের কলাম সংখ্যা। সংখ্যায়ন ০ হতে শুরু হয়।
16 | সারি | উপাদানের সারি সংখ্যা; সংখ্যায়ন ০ হতে শুরু হয়।
18 | ট্যাব | উপাদানের টেবিল সংখ্যা; সংখ্যায়ন ০ হতে শুরু হয়।
20 | ত্রুটি | ত্রুটি সংখ্যা, যেখানে মান ০ "ত্রুটিহীন" হিসেবে নির্ধারিত। যদি উপাদানটি একটি সূত্র ঘর থেকে আসে, সূত্র দ্বারা ত্রুটি মান নির্ধারণ করা হয়।
22 | Len | নিম্নের স্ট্রিংএর দৈর্ঘ্য, শেষের শূন্য বাইট সহ। যদি শেষের শূন্য বাইটসহ দৈর্ঘ্য একটি বিজোড় মান হয়, তাহলে একটি জোড় মান পাওয়ার জন্য স্ট্রিংএর সাথে আরেকটি শূন্য বাইট যোগ করা হয়। ফলে, দৈর্ঘ্য হিসাব করা হয় ((StrLen+২)&~১) ব্যবহার করে।
24 | স্ট্রিং | শেষের শূন্য বাইট সহ স্ট্রিং
24+Len | ... | পরবর্তী উপাদান

### ঘর অ্যারে

টেক্সট বা সংখ্যা রয়েছে এমন ঘরের এলাকা কল করতে, ঘর অ্যারে ব্যবহার করা হয়। LibreOffice ক্যালকে ঘর অ্যারে নিম্নরূপে নির্ধারণ করা হয়:

Offset | Name | Description
--- | --- | ---
0 | কলাম-১ | ঘরের এলাকার উপর-বাম কোনায় কলাম নম্বর। সংখ্যায়ন ০ হতে শুরু হয়।
2 | সারি-১ | ঘরের এলাকার উপর-বাম কোনায় সারি নম্বর; সংখ্যায়ন ০ হতে শুরু হয়।
4 | ট্যাব-১ | ঘরের উপরে-বাম কোণে টেবিল নাম্বার; সংখ্যায়ন ০ থেকে শুরু।
6 | কলাম-২ | ঘরের এলাকার নিচের-ডান কোনায় কলাম নম্বর। সংখ্যায়ন ০ হতে শুরু হয়।
8 | সারি-২ | ঘরের এলাকার নিচের-ডান কোনায় সারি নম্বর; সংখ্যায়ন ০ হতে শুরু হয়।
10 | ট্যাব-২ | ঘরের এলাকার নিচের-ডান কোনায় টেবিল নম্বর; সংখ্যায়ন ০ হতে শুরু হয়।
12 | গণনা | নিম্নের উপাদান সংখ্যা। ফাঁকা ঘর গণনা করা হয় না বা পাস করা হয় না।
14 | কলাম | উপাদানের কলাম সংখ্যা। সংখ্যায়ন ০ হতে শুরু হয়।
16 | সারি | উপাদানের সারি সংখ্যা; সংখ্যায়ন ০ হতে শুরু হয়।
18 | ট্যাব | উপাদানের টেবিল সংখ্যা; সংখ্যায়ন ০ হতে শুরু হয়।
20 | ত্রুটি | ত্রুটি সংখ্যা, যেখানে মান ০ "ত্রুটিহীন" হিসেবে নির্ধারিত। যদি উপাদানটি একটি সূত্র ঘর থেকে আসে, সূত্র দ্বারা ত্রুটি মান নির্ধারণ করা হয়।
22 | ধরন | ঘরের বিষয়বস্তুর ধরন, 0 == ডবল, 1 == স্ট্রিং
24 | মান বা দৈর্ঘ্য | যদি type == 0 হয়: ডবল/ফ্লোটিং পয়েন্টের ৮ বাইট IEEE ভেরিয়েবল যদি type == 1 হয়: নিম্নের স্ট্রিংএর দৈর্ঘ্য, শেষের শূন্য বাইট সহ। যদি শেষের শূন্য বাইটসহ দৈর্ঘ্য একটি বিজোড় মান হয়, তাহলে একটি জোড় মান পাওয়ার জন্য স্ট্রিংএর সাথে আরেকটি শূন্য বাইট যোগ করা হয়। ফলে, দৈর্ঘ্য হিসাব করা হয় ((StrLen+২)&~১) ব্যবহার করে।
২৬, যদি type==1 হয় | স্ট্রিং | যদি type == 1 হয়: শেষের শূন্য বাইট সহ স্ট্রিং
৩২ বা ২৬+দৈর্ঘ্য | ... | পরবর্তী উপাদান