استعراض أي شيء

Function: BrowseSpecialRootFolder

الغرض
استعراض مجلد بما في ذلك أحد المجلدات الخاصة، مثل My Documents أو Program Files أو سلة المحذوفات، أو أحد البنود الظاهرية مثل جهاز الكمبيوتر.

الصيغة

function BrowseSpecialRootFolder(hOwner: HWND; FolderID: Integer; Flags: Integer; Prompt: string; ReturnDisplayName: Boolean = False): string;

الوسائط (Parameters)

الشرح
تعمل هذه الدالة على عرض نافذة الاستعراض التابعة للنظام، و تعيد اختيار المستخدم بعدما ينقر الزر موافق. هذه الدالة يمكن استعمالها للوصول إلى أي مجلد في النظام بما في ذلك المجلدات الخاصة، و كذلك الحصول على أسماء الملفات و البنود التي لا تمثل في الحقيقة مجلدات و لا ملفات، مثل أسماء الطابعات أو جهاز الكمبيوتر.
* البارامتر FolderID يحدد ما هو البند الذي سيكون بمثابة الجذر الأعلى للشجرة في نافذة الستعراض. للحصول على قائمة كاملة بالقيم المقبولة لهذا البارامتر، انظر موضوع الوصول إلى مجلد خاص (GetSpecialFolderPath).
* البارامتر ReturnDisplayName مهم، فهو يحدد ما ستعيده الدالة. إذا كانت قيمته True فإن الدالة تعيد الاسم الذي يظهر به البند المحدد، مثل المستندات أو المجلد10 أو مواضع شبكة الاتصال أو جهاز الكمبيوتر. أما إذا كانت قيمته False فإن الدالة تعيد المسار الكامل للبند المحدد، مثل C:\My Documents أو D:\MainFolder\المجلد10.
واضح أن هذا البارامتر يجب أن يكون أحياناً True، لأن بعض البنود هي بنود ظاهرية (Virtual) و بالتالي ليس لها مسار، مثل جهاز الكمبيوتر (ليس هناك مجلد اسمه جهاز الكمبيوتر) أو مواضع شبكة الاتصال (ليس هناك مجلد اسمه مواضع شبكة الاتصال).
* البارامتر Flags يحدد مواصفات و سلوك نافذة الاستعراض، و يمكن أن يأخذ إحدى القيم التالية (يمكن دمج قيمتين أو أكثر باستعمال العامل OR):

 أعلى الصفحة