اضافه کردن توضیحات به توابع در اکسل

266
بدون دیدگاه
اضافه کردن توضیحات به توابع در اکسل

در مطلب “اضافه کردن توابع جدید به اکسل” دیدیم که چطور به کمک کدنویسی در VBA می توان به سادگی توابع جدیدی به اکسل اضافه کرد و در قالب یک مثال تابعی جهت محاسبه شاخص BMI تعریف کردیم. در اینجا می خواهیم به توابع جدید و آرگومان های آن توضیحاتی همانند خود توابع اکسل اضافه کنیم. در تصویر ذیل پنجره تابع SUM اکسل و تابعی که ما به اکسل اضافه کردیم نشان داده شده است.

اضافه کردن توضیحات به توابع در اکسل
اضافه کردن توضیحات به توابع در اکسل

همانطور که مشاهده می کنید برای تابع SUM، اکسل کارکرد اصلی آن و همچنین توضحیاتی در مورد آرگومان ها ارایه داده اما تابعی که ما تعریف کرده ایم فاقد هر گونه توضیحی است.

کد اضافه کردن توضیحات به توابع

بهتر است برای توابع جدیدی که در اکسل تعریف می کنیم توضیحاتی در خصوص مقصود اصلی تابع، آرگومان های تابع، نوع ورودی هر آرگومان (متنی، عددی، تاریخ و …) جهت راهنمایی استفاده کنندگان از تابع، اضافه کرد. فرمت کلی اضافه کردن توضیحات به توابع در اکسل به صورت ذیل است:

Sheet1.ir

'=========== Sheet1.ir =================== 
Sub DescribeFunction() 
     Dim F_Name, F_Des, Category As String 
     Dim ArgDes(1 To 2) As String تعداد آرگومان ها 
     
     F_Name = نام تابع 
     F_Des = توضيح کلي تابع 
     Category = دسته تابع: متني، رياضي، آماري و ... 
     
     ArgDes(1) = توضيح مربوط به آرگومان اول 
     ArgDes(2) = توضيح مربوط به آرگومان دوم 
     
     Application.MacroOptions Macro:=F_Name, _ 
     Description:=F_Des, Category:=Category, _ 
     ArgumentDescriptions:=ArgDes 
End Sub

Sheet1.ir

  • در خط 4 تعداد آرگومان های تابع مشخص می شود: تابع BMI دارای 2 آرگومان است.
  • در خط 6 نام تابع مورد نظر نوشته می شود : برای مثال ما BMI
  • در خط 7 توضیح کلی تابع یا مقصود اصلی آن مشخص می شود:  توضیح تابع BMI “شاخص توده بدنی جهت شناسایی اضافه یا کمبود وزن”
  • در خط 8 دسته بندی کلی تابع را با توجه به جدول ذیل مشخص می کنیم:
شمارهدسته یندی
1Financial
2Date & Time
3Math & Trig
4Statistical
5Lookup & Reference
6Database
7Text
8Logical
9Information
10Commands
11Customizing
12Macro Control
13DDE/External
14User Defined
15دسته بندی سفارشی اول
16دسته بندی سفارشی دوم
::::::
32دسته بندی سفارشی هجدهم

منبع : مایکروسافت

در صورتی که می خواهید یک  دسته بندی سفارشی داشته باشید کافی است عنوان مورد نظر خود را در خط 8 وارد کنید. در این مثال می خواهیم تابع در یک دسته بندی به نام “My Functions” قرار گیرد.

  • در خط 10 و 11 نیز توضیحات مربوط به آرگومان های تابع مشخص می شود: در تابع BMI آرگومان اول “وزن بر حسب کیلوگرم” و آرگومان دوم “قد بر حسب متر”

در نهایت کد مربوط به اضافه کردن توضیحات به تابع BMI به صورت ذیل خواهد بود:

Sheet1.ir

'=========== Sheet1.ir ===================
    Sub DescribeFunction()
    Dim FuncName As String
    Dim FuncDesc As String
    Dim Category As String
    Dim ArgDesc(1 To 2) As String
    
    FuncName = "BMI"
    FuncDesc = "شاخص توده بدنی جهت شناسایی اضافه یا کمبود وزن"
    Category = "My Functions"
    
    ArgDesc(1) = "وزن بر حسب کیلوگرم"
    ArgDesc(2) = "قد برحسب متر"
    
    Application.MacroOptions _ Macro:=FuncName, _
    Description:=FuncDesc, _
    Category:=Category, _
    ArgumentDescriptions:=ArgDesc
End Sub

Sheet1.ir

حال کافی است یک بار این کد را اجرا کنید (کلید F5) تا تمامی تغییرات اعمال شود. دوباره پنجره توضیحات تابع BMI را باز کنید و تغییرات را مشاهده کنید:

اضافه کردن توضیحات به توابع در اکسل

همچنین یک دسته بندی جدید به نام “My Functions” به توابع اکسل اضافه شده و تابع BMI در آن قرار گرفته است:

اضافه کردن توضیحات به توابع در اکسل

در ادامه می توانید فایل مثال اکسل اضافه کردن توضیحات به توابع را دریافت نمایید

تعداد دانلود : 31

مطالب مرتبط :

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

این قسمت نباید خالی باشد
این قسمت نباید خالی باشد
لطفاً یک نشانی ایمیل معتبر بنویسید.
شما برای ادامه باید با شرایط موافقت کنید

حداکثر حجم مجاز فایل : 5 مگابایت فرمت های مجاز : jpeg - jpg - png - pdf- xls - xlsx - xlsb - xlsm - txt - csv - zip - rar فایل ها را اینجا بکشید

keyboard_arrow_up