شرح كامل لاستخدام الاداة SSTAB والتحكم بها ، Using SSTAB control

Using the SSTab Control

The SSTab control provides an easy way of presenting several dialogs or screens of information on a single form using the same interface seen in many commercial Microsoft Windows applications.
The SSTab control provides a group of tabs, each of which acts as a container for other controls. Only one tab is active in the control at a time, displaying the controls it contains to the user while hiding the controls in the other tabs.



Possible Uses

• To create a Microsoft Office or Windows 95 (or later) style tabbed dialog box.
  
• To create a custom tabbed dialog box.
  

Setting Tabs and Tab Rows

Before setting the number of tabs you want to add to the SSTab control, you should first decide what your dialog box will contain and how it will be organized.
While you can set the numbers of tabs at both design time and run time, you will more than likely find that creating your tabbed dialog at design time is much quicker and easier. You can set properties at design time using the SSTab Property Pages which is available by right-clicking the control and then selecting Properties.


You set the Tab and TabsPerRow properties to define the number of tabs and rows in your dialog box. For example, if you want to a create a tabbed dialog that contains twelve tabs you set the Tab Count option to ‘12’ and the TabsPerRow option to ‘4’ — this creates a tabbed dialog containing three rows of four tabs each. By default, the number of tabs is set at 3.
When the number of tabs and rows has been set, each tab is indexed and can then be selected individually. For example, you can select individual tabs in the Current Tab option to change the TabCaption property. Tabs are indexed beginning at zero (0).
At run time, the user can navigate through the tabs by either clicking on them, by pressing CTRL TAB, or by using mnemonics defined in the caption of each tab. For example, if you wanted to create a tab called ‘Print’ and allow the user to access the tab with the keyboard combination ALT P, you set the TabCaption property to ‘&Print’.

Adding Controls to Tabs

Each tab in the SSTab control is essentially a container for other controls. When you create a tabbed dialog box, you group controls together that perform similar functions, such as printing a document or setting display options for your application. Once you’ve determined how many tabs you need in your tabbed dialog box, you add whichever controls you need to perform those functions.
To add controls to individual tab pages at design time, first select the tab by clicking on it, then draw the controls on the tab page.
Note You should not add controls to individual tab pages using the double-click method. Double-clicking a control from the toolbox onto a tab page places that control on every tab in the SSTab control.

Enabling and Disabling Tabs at Run Time

Depending upon the functionality of your application or a particular tabbed dialog box you create, you may want to disable some tabs in certain situations. You use the TabEnabled property to enable and disable individual tabs. When a tab is disabled, the text on the tab is grayed out and the user cannot select that tab. For example:
SSTab1.TabEnabled(2) = False

The TabEnabled property specifies the tab number, then disables it by setting the value to False.
Note Use the Enabled property to enable or disable the entire SSTab control.

Tab Customizing Properties

Using the SSTab control properties, you can customize the look and functionality of your tabbed dialog box. You can set these properties at design time using the control’s Property Pages or at run time in code.

The Style Property

The Style property gives you two options for setting the style of your tabbed dialog box. By default, the Style property is set to display as a Microsoft Office tabbed dialog. The tabs that appear when this option is selected look like those in Microsoft Office for Microsoft Windows 3.1 applications. By default, the selected tab caption text is displayed in bold.


The second option available is the Windows 95 (or later) Property Pages tabbed dialog style. This tabbed dialog style conforms to the user interface standards developed for Windows 95. The selected tab caption text, unlike the Microsoft Office style, is not displayed as bold.


To set this property at run time use the Visual Basic constants ssStyleTabbedDialog or ssStylePropertyPage to specify either style.

The TabOrientation Property

The TabOrientation property allows you to locate the tabs of your tabbed dialog box on either of the four sides (top, bottom, left, right). For example:


When you set the orientation of the tabs to something other than top or bottom, you must also change the font style of the tabs. Setting the tabs to left or right rotates the text vertically and only TrueType^® fonts display vertically in the SSTab control. Change the font style using the Font property or by selecting the Font tab in the control’s Property Pages. Arial is a common substitute for the Windows default sans serif font.
You can set this property at run time using the following Visual Basic constants: ssTabOrientationTop, ssTabOrientationBottom, ssTabOrientationLeft, and ssTabOrientationRight.

The Picture Property

You can add pictures (bitmaps, icons, or metafiles) to any or all of the tabs in the SSTab control. For example:


At design time, you set the Picture property for a tab by clicking that tab and then setting the property in the Properties window. At run time, you can set the Picture property using the LoadPicture function or the Picture property of another control or of a Form object.
Note When setting the Picture property at design time, the graphic is saved and loaded with the Form object containing the SSTab control. If you create an executable file, the file contains the image. When you load a graphic at run time, the graphic isn't saved with the application.
Setting the Picture property affects the value of the TabPicture property for the current tab as well as displays the picture in the active tab.

Adjusting Tab Height and Width

Depending upon its size, you may need to resize the tab height to accommodate the image. Use the TabMaxHeight property to adjust the height of the tabs. The TabMaxHeight property sets the height for every tab in the control — individual tabs cannot be adjusted separately.
If you’re using the Microsoft Office style tabbed dialog, you may also need to set the TabMaxWidth property to allow both the image and the text to fit on the tab. If you’re using the Windows 95 style tabbed dialog, the TabMaxWidth property is ignored and the width of each tab adjusts to the combined width of the image and the length of the text in its caption.

Setting the WordWrap Property

When using the Microsoft Office style tabbed dialog, you may specify the exact width of the tabs using the TabMaxWidth property. Having done so, you can then allow tab captions to wrap to the next line, if necessary, by setting the WordWrap property to True. Although caption text will wrap, you are still limited by the height and width of the tabs. In other words, you may still get clipped or hidden caption text if the height and width are insufficient.
The Windows 95–style tabbed dialog sets tab width based on the length of the caption text; the TabMaxWidth and WordWrap property settings are ignored

You can Also set Active Tabe by cod " To Set TAB3 to be active tab "

SSTAB1.Tab=2 ' Tab 3 Number = 2

شكرا جزيلا للعضو 123 على هذا الموضوع

*****************************************

( ترجمة الموضوع )

Using the SSTab Control

اداة التحكم SSTab توفر طريقة سهلة لتقديم العديد من الحوارات أو شاشات المعلومات في نموذج واحد باستخدام واجهة تظهر في العديد من التطبيقات التجارية لمايكروسوفت ويندوز.
يوفر عنصر التحكم SSTab مجموعة من علامات التبويب ، كل واحدة منها بمثابة حاوية لعناصر أخرى. تبويب واحد فقط يكون نشط فى نفس الوقت الذى يعرض ادواته للمستخدم ، في الوقت الذي يخبئ عناصر التحكم في علامات التبويب الأخرى.



ممكن استخدامه في أغراض


لإنشاء مكتبات مايكروسوفت ويندوز أو نمط مربع الحوار المخصص.

لإنشاء مربعات الحوار المخصصة .



Setting Tabs and Tab Rows ضبط اعدادت الاداة

قبل تعيين عدد من علامات التبويب التي تريد إضافتها إلى عنصر التحكم ، يجب أن تقرر أولا ما مربع الحوار الخاص بك و الكيفية التي سيتم تنظيمها.
بينما يمكنك تعيين عدد من علامات التبويب في كل من وقت التصميم ووقت التشغيل ، وسوف يكون من المرجح أن تجد أن انشاء الحوار الخاص اقل كلفه (جهدا) في وقت التصميم وهو أسرع وأسهل بكثير. يمكنك تعيين الخصائص في وقت التصميم باستخدام الخاصية SSTab ،التي تتوفر عن طريق النقر بالزر الأيمن التحكم ثم تحديد خصائص
يمكنك تعيين علامة التبويب والخصائص TabsPerRow لتحديد عدد من علامات التبويب والصفوف في مربع الحوار الخاص بك. على سبيل المثال ، إذا كنت تريد إنشاء الحوار الذي يحتوي على اثنتي عشرة جدول من علامات التبويب قم بتعيين الخيار عدد التبويب إلى '12' والخيار TabsPerRow إلى '4' -- وهذا ينشئ جدول يحتوي على ثلاثة صفوف من كل أربع علامات. افتراضيا ، يتم تعيين عدد من علامات التبويب في 3.
عندما يتم تعيين عدد من علامات التبويب والصفوف ، تتم فهرسة كل علامة تبويب ويمكن بعد ذلك اختيار احداهم بشكل فردي

عند تعيين اتجاه من علامات التبويب إلى شيء آخر من أعلى أو أسفل ، عليك أيضا تغيير نمط الخط من علامات التبويب. وضع علامات التبويب إلى اليسار أو استدارة النص عموديا في عنصر التحكم SSTab. تغيير نمط الخط باستخدام الخاصية خط أو عن طريق اختيار علامة التبويب الخط في صفحات الخصائص لعنصر التحكم. الخط ارييل هو بديل مشترك للخط الافتراضي ويندوز شريف.
يمكنك تعيين هذه الخاصية في وقت التشغيل باستخدام ما يلي من الثوابت البصرية الأساسية : ssTabOrientationTop ، ssTabOrientationBottom ، ssTabOrientationLeft ، وssTabOrientationRight.


The Picture Property خاصية الصورة

يمكنك إضافة الصور (الصور النقطية والرموز ، أو تعريف) إلى أي أو كافة علامات التبويب في عنصر التحكم SSTAB . على سبيل المثال :


في وقت التصميم ، يمكنك تعيين الخاصية صورة لعلامة التبويب بالنقر هذا التبويب ثم تعيين الخاصية في إطار خصائص. في وقت التشغيل ، يمكنك تعيين الخاصية صورة باستخدام الدالة LoadPicture أو الخاصية صورة عنصر تحكم آخر أو من كائن النموذج.
ملاحظة عند تعيين الخاصية صورة في وقت التصميم ، الرسم يتم حفظ وتحميلة كنموذج كائن يحتوي على عنصر التحكم SSTab. إذا قمت بإنشاء ملف تنفيذي ، فالملف سيحتوي على الصورة. أما عند تحميل رسم في وقت التشغيل ، لا يتم حفظ الرسم مع التطبيق.
تعيين الخاصية صورة يؤثر على قيمة الممتلكات TabPicture لعلامة التبويب الحالية ، وكذلك يعرض الصورة في علامة التبويب النشطة.



Adjusting Tab Height and Width ضبط ارتفاع وعرض اداة الجدولة

اعتمادا على حجمها ، قد تحتاج لتغيير حجم الارتفاع للتبويب لاستيعاب الصورة. استخدام الخاصية TabMaxHeight لضبط ارتفاع الاداة . الخاصية TabMaxHeight مجموعات ذروة لكل التبويب في عنصر التحكم -- لا يمكن أن يتم ضبط العلامات الفردية بشكل منفصل.
إذا كنت تستخدم أسلوب مايكروسوفت أوفيس كلغه للحوار ، قد تحتاج أيضا إلى تعيين الخاصية TabMaxWidth للسماح كل من الصورة والنص لاحتوائه على علامة التبويب. إذا كنت تستخدم ويندوز 95 على غرار الحوار المبوب ، يتم تجاهل الخاصية TabMaxWidth وعرض كل علامة تبويب يضبط إلى عرض من الجمع بين الصورة وطول النص في تعليق لها.


Setting the WordWrap Property اعداد خاصية تدوير الكلمات ( لف الكلمات )

عند استخدام أسلوب الحوار كلغه مايكروسوفت أوفيس ، يمكنك تحديد العرض الدقيق للعلامات باستخدام الخاصية TabMaxWidth. بعد أن تفعل ذلك ، يمكنك السماح ثم تعليق التبويب بالالتفاف إلى السطر التالي ، إذا لزم الأمر ، عن طريق تعيين الخاصية لف الكلمات إلى صحيح. على الرغم من أن نص التسمية التوضيحية سيتم التفافه ،الا انها لا تزال محدودة إليكم من ارتفاع وعرض علامات التبويب. وبعبارة أخرى ، قد يحدث قص النص او اختفاء جزء منه إذا كان الطول والعرض غير كافي.
ويندوز 95 - نمط الحوار كلفه مجموعات عرض التبويب استنادا إلى طول النص التوضيحية ، وTabMaxWidth وإعدادات الخاصية يتم تجاهل لف الكلمات

You can Also set Active Tabe by cod " To Set TAB3 to be active tab "
يمكنك ايضا تحديد الجدول النشط باستخدام الكود كالتالى