Author:admin

Date:2008-09-17T13:53:28.000000Z


git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@3 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
This commit is contained in:
jfiat
2008-09-17 13:53:28 +00:00
parent 4fee9356ea
commit 2ee31ab9c7
763 changed files with 36576 additions and 0 deletions

View File

@@ -0,0 +1,54 @@
[[Property:title|Controls]]
[[Property:link_title|controls cluster]]
[[Property:weight|1]]
==Overview==
A Control is a window which provides a means of interacting with the application. For example, the [[ref:libraries/wel/reference/wel_edit_chart|WEL_EDIT]] control provides a user with the means of entering and modifying text. There are many common controls available within this cluster, each with a specific use.
{{note| '''Note:''' Each control inherits from [[ref:libraries/wel/reference/wel_control_chart|WEL_CONTROL]] which is a descendent of [[ref:libraries/wel/reference/wel_window_chart|WEL_WINDOW]] This provides the control with a large number of general features (including full window functionality). Each control also provides its own feature set which give access to specific properties of that control. }}
==Creating controls==
Each type of control generally has its own creation procedure that is specific to the type of control. For example, [[ref:libraries/wel/reference/wel_scroll_bar_chart|WEL_SCROLL_BAR]] has two creation procedures; make_vertical and make_horizontal. Depending on which of these two creation procedures used, you will get a scroll bar aligned vertically or horizontally.
==Control types==
The following effective controls are available within this cluster:
* [[ref:libraries/wel/reference/wel_bitmap_button_chart|WEL_BITMAP_BUTTON]]
* [[WEL_CHECKBOX|WEL_CHECK_BOX]]
* [[WEL_CHECK_BOX_3_STATE|WEL_CHECK_BOX_3_STATE]]
* [[ref:libraries/wel/reference/wel_drop_down_combo_box_chart|WEL_DROP_DOWN_COMBO_BOX]]
* [[ref:libraries/wel/reference/wel_drop_down_combo_box_ex_chart|WEL_DROP_DOWN_COMBO_BOX_EX]]
* [[ref:libraries/wel/reference/wel_drop_down_list_combo_box_chart|WEL_DROP_DOWN_LIST_COMBO_BOX]]
* [[ref:libraries/wel/reference/wel_drop_down_list_combo_box_ex_chart|WEL_DROP_DOWN_LIST_COMBO_BOX_EX]]
* [[ref:libraries/wel/reference/wel_flat_tool_bar_chart|WEL_FLAT_TOOL_BAR]]
* [[WEL_GROUP_BOX|WEL_GROUP_BOX]]
* [[ref:libraries/wel/reference/wel_header_control_chart|WEL_HEADER_CONTROL]]
* [[ref:libraries/wel/reference/wel_imagelist_tool_bar_chart|WEL_IMAGE_LIST_TOOL_BAR]]
* [[WEL_LIST_VIEW|WEL_LIST_VIEW]]
* [[WEL_MULTIPLE_LINE_EDIT|WEL_MULTIPLE_LINE_EDIT]]
* [[WEL_MULTIPLE_SELECTION_LIST_BOX|WEL_MULTIPLE_SELECTION_LIST_BOX]]
* [[ref:libraries/wel/reference/wel_owner_draw_button_chart|WEL_OWNER_DRAW_BUTTON]]
* [[WEL_PROGRESS_BAR|WEL_PROGRESS_BAR]]
* [[WEL_PUSH_BUTTON|WEL_PUSH_BUTTON]]
* [[WEL_RADIO_BUTTON|WEL_RADIO_BUTTON]]
* [[ref:libraries/wel/reference/wel_rebar_chart|WEL_REBAR]]
* [[ref:libraries/wel/reference/wel_rich_edit_chart|WEL_RICH_EDIT]]
* [[WEL_SCROLL_BAR|WEL_SCROLL_BAR]]
* [[ref:libraries/wel/reference/wel_selectable_button_chart|WEL_SELECTABLE_BUTTON]]
* [[ref:libraries/wel/reference/wel_simple_combo_box_chart|WEL_SIMPLE_COMBO_BOX]]
* [[WEL_SINGLE_LINE_EDIT|WEL_SINGLE_LINE_EDIT]]
* [[WEL_SINGLE_SELECTION_LIST_BOX|WEL_SINGLE_SELECTION_LIST_BOX]]
* [[ref:libraries/wel/reference/wel_static_chart|WEL_STATIC]]
* [[ref:libraries/wel/reference/wel_static_bitmap_chart|WEL_STATIC_BITMAP]]
* [[ref:libraries/wel/reference/wel_status_window_chart|WEL_STATUS_WINDOW]]
* [[ref:libraries/wel/reference/wel_tab_control_chart|WEL_TAB_CONTROL]]
* [[ref:libraries/wel/reference/wel_tool_bar_chart|WEL_TOOL_BAR]]
* [[WEL_TOOLTIP|WEL_TOOLTIP]]
* [[WEL_TRACK_BAR|WEL_TRACK_BAR]]
* [[ref:libraries/wel/reference/wel_tree_view_chart|WEL_TREE_VIEW]]
* [[WEL_UP_DOWN_CONTROL|WEL_UP_DOWN_CONTROL]]

View File

@@ -0,0 +1,21 @@
[[Property:title|WEL_CHECK_BOX_3_STATE]]
[[Property:weight|1]]
[[ref:libraries/wel/reference/wel_check_box_3_state_chart| A WEL_CHECK_BOX_3_STATE]] control can take three states, checked, indeterminate or unchecked.
==Appearance==
A [[ref:libraries/wel/reference/wel_check_box_3_state_chart|WEL_CHECK_BOX_3_STATE]] <br/>
[[Image:wel-check-box-3-state-unchecked|wel_check_box_3_state_unchecked]] <br/>
<br/>
A checked [[ref:libraries/wel/reference/wel_check_box_3_state_chart|WEL_CHECK_BOX_3_STATE]] <br/>
[[Image:wel-check-box-3-state-checked|wel_check_box_3_state_checked]] <br/>
<br/>
A indeterminate [[ref:libraries/wel/reference/wel_check_box_3_state_chart|WEL_CHECK_BOX_3_STATE]] <br/>
[[Image:wel-check-box-3-state-indeterminate|wel_check_box_3_state_indeterminate]] <br/>
<br/>
{{seealso| '''See also''' <br/>
[[WEL_CHECKBOX|WEL_CHECK_BOX]] }}

View File

@@ -0,0 +1,16 @@
[[Property:title|WEL_CHECKBOX]]
[[Property:weight|0]]
A [[ref:libraries/wel/reference/wel_check_box_chart|WEL_CHECK_BOX]] control can take two states, checked or unchecked.
==Appearance==
A [[ref:libraries/wel/reference/wel_check_box_chart|WEL_CHECK_BOX]] <br/>
[[Image:wel-check-box-unchecked|wel_check_box_unchecked]] <br/>
<br/>
A checked [[ref:libraries/wel/reference/wel_check_box_chart|WEL_CHECK_BOX]] <br/>
[[Image:wel-check-box-checked|wel_check_box_checked]]
{{seealso| '''See also''' <br/>
[[WEL_CHECK_BOX_3_STATE|WEL_CHECK_BOX_3_STATE]] }}

View File

@@ -0,0 +1,8 @@
[[Property:title|WEL_UP_DOWN_CONTROL]]
[[Property:weight|15]]
A [[ref:libraries/wel/reference/wel_up_down_control_chart|WEL_UP_DOWN_CONTROL]] consists of a pair of arrows which are used to increment or decrement a value. Using set_buddy_window, a window of type [[ref:libraries/wel/reference/wel_window_chart|WEL_WINDOW]] can be linked to this control, and is commonly used to display the current value.
==Appearance==
[[Image:wel-up-down-control|wel_up_down_control]]

View File

@@ -0,0 +1,9 @@
[[Property:title|WEL_GROUP_BOX]]
[[Property:weight|2]]
A [[ref:libraries/wel/reference/wel_group_box_chart|WEL_GROUP_BOX]] is used to enclose other controls, and certain controls such as a [[WEL_RADIO_BUTTON|WEL_RADIO_BUTTON]] have special behavior when parented in a [[ref:libraries/wel/reference/wel_group_box_chart|WEL_GROUP_BOX]] .
==Appearance==
[[Image:wel-group-box|wel_group_box]]

View File

@@ -0,0 +1,18 @@
[[Property:title|WEL_LIST_VIEW]]
[[Property:weight|3]]
A [[ref:libraries/wel/reference/wel_list_view_chart|WEL_LIST_VIEW]] control is an encapsulation of the Windows List View control and provides several ways of displaying a collection of items. Each item can consist of a text and an icon. Certain styles allow additional information to be displayed in columns to the right of the icon and label.
==Appearance==
A [[ref:libraries/wel/reference/wel_list_view_chart|WEL_LIST_VIEW]] with the Lvs_report style. <br/>
[[Image:wel-list-view-style-lvs-report|list_view_style_lvs_report]] <br/>
<br/>
A [[ref:libraries/wel/reference/wel_list_view_chart|WEL_LIST_VIEW]] with the Lvs_list style. <br/>
[[Image:wel-list-view-style-lvs-list|list_view_style_lvs_list]] <br/>
<br/>
A [[ref:libraries/wel/reference/wel_list_view_chart|WEL_LIST_VIEW]] with the Lvs_icon style. <br/>
[[Image:wel-list-view-style-lvs-icon|list_view_style_lvs_icon]] <br/>
<br/>
A [[ref:libraries/wel/reference/wel_list_view_chart|WEL_LIST_VIEW]] with the Lvs_smallicon style. <br/>
[[Image:wel-list-view-style-lvs-small-icon|list_view_style_lvs_icon_small]]

View File

@@ -0,0 +1,9 @@
[[Property:title|WEL_MULTIPLE_LINE_EDIT]]
[[Property:weight|4]]
A [[ref:libraries/wel/reference/wel_multiple_line_edit_chart|WEL_MULTIPLE_LINE_EDIT]] is used to display multiple lines of text. Using set_read_only, the text can be made non-editable.
==Appearance==
[[Image:wel-multiple-line-edit|wel_multiple_line_edit]]

View File

@@ -0,0 +1,14 @@
[[Property:title|WEL_MULTIPLE_SELECTION_LIST_BOX]]
[[Property:weight|5]]
A [[ref:libraries/wel/reference/wel_multiple_selection_list_box_chart|WEL_MULTIPLE_SELECTION_LIST_BOX ]] is a control used to display a list of <eiffel>STRING</eiffel>. Multiple items may be selected at once.
==Appearance==
[[Image:wel-multiple-selection-list-box|wel_multiple_selection_list_box]] <br/>
<br/>
{{seealso| '''See also''' <br/>
[[WEL_SINGLE_SELECTION_LIST_BOX|WEL_SINGLE_SELECTION_LIST_BOX]] }}

View File

@@ -0,0 +1,14 @@
[[Property:title|WEL_OWNER_DRAW_BUTTON]]
[[Property:weight|6]]
A [[ref:libraries/wel/reference/wel_owner_draw_button_chart|WEL_OWNER_DRAW_BUTTON]] is a control that the user can click to provide notification to the application, and behaves in a similar fashion to [[ref:libraries/wel/reference/wel_push_button_chart|WEL_PUSH_BUTTON]] except that <eiffel>on_paint</eiffel> must be implemented to give the button the desired appearance.
==Appearance==
There is no sample appearance for this control.
{{seealso| '''See also''' <br/>
[[WEL_PUSH_BUTTON|WEL_PUSH_BUTTON]] }}

View File

@@ -0,0 +1,12 @@
[[Property:title|WEL_PROGRESS_BAR]]
[[Property:weight|7]]
A [[ref:libraries/wel/reference/wel_progress_bar_chart|WEL_PROGRESS_BAR]] control is an encapsulation of the Win32 progress bar. It can be used to display the progress of a lengthy operation.
{{note| '''Note:''' By specifying the style Pbs_vertical, the progress bar will be displayed vertically. }}
==Appearance==
A [[ref:libraries/wel/reference/wel_progress_bar_chart|WEL_PROGRESS_BAR]] . <br/>
[[Image:wel-progress-bar-half|wel_progress_bar_half]]

View File

@@ -0,0 +1,8 @@
[[Property:title|WEL_PUSH_BUTTON]]
[[Property:weight|8]]
A [[ref:libraries/wel/reference/wel_push_button_chart|WEL_PUSH_BUTTON]] is a control that the user can click to provide notification to the application.
==Appearance==
[[Image:wel-push-button|wel_push_button]]

View File

@@ -0,0 +1,13 @@
[[Property:title|WEL_RADIO_BUTTON]]
[[Property:weight|9]]
A [[ref:libraries/wel/reference/wel_radio_button_chart|WEL_RADIO_BUTTON]] control can take two states, checked or unchecked. By placing more than one of these in a [[ref:libraries/wel/reference/wel_group_box_chart|WEL_GROUP_BOX]] , they will become grouped, and only one may be checked at once.
==Appearance==
A [[ref:libraries/wel/reference/wel_radio_button_chart|WEL_RADIO_BUTTON]] <br/>
[[Image:wel-radio-button-unchecked|wel_radio_button_unchecked]] <br/>
<br/>
A checked [[ref:libraries/wel/reference/wel_radio_button_chart|WEL_RADIO_BUTTON]] <br/>
[[Image:wel-radio-button-checked|wel_radio_button_checked]]

View File

@@ -0,0 +1,13 @@
[[Property:title|WEL_SCROLL_BAR]]
[[Property:weight|10]]
A [[ref:libraries/wel/reference/wel_scroll_bar_chart|WEL_SCROLL_BAR]] control is an encapsulation of the Windows scroll bar control and is often used to specify which portion of a large control that cannot be viewed completely, is currently visible.
==Appearance==
A [[ref:libraries/wel/reference/wel_scroll_bar_chart|WEL_SCROLL_BAR]] created with <eiffel>make_horizontal</eiffel>. <br/>
[[Image:wel-scroll-bar-horizontal|wel_scroll_bar_horizontal]] <br/>
<br/>
A [[ref:libraries/wel/reference/wel_scroll_bar_chart|WEL_SCROLL_BAR]] created with <eiffel>make_vertical</eiffel>. <br/>
[[Image:wel-scroll-bar-vertical|wel_scroll_bar_vertical]]

View File

@@ -0,0 +1,8 @@
[[Property:title|WEL_SINGLE_LINE_EDIT]]
[[Property:weight|11]]
A [[ref:libraries/wel/reference/wel_single_line_edit_chart|WEL_SINGLE_LINE_EDIT]] is a control used to input a single line of text.
==Appearance==
[[Image:wel-single-line-edit|wel_single_line_edit]]

View File

@@ -0,0 +1,14 @@
[[Property:title|WEL_SINGLE_SELECTION_LIST_BOX]]
[[Property:weight|12]]
A [[ref:libraries/wel/reference/wel_single_selection_list_box_chart|WEL_SINGLE_SELECTION_LIST_BOX]] is a control used to display a list of <eiffel>STRING</eiffel>. Only one item may be selected at once.
==Appearance==
[[Image:wel-single-selection-list-box|wel_single_selection_list_box]] <br/>
<br/>
{{seealso| '''See also''' <br/>
[[WEL_MULTIPLE_SELECTION_LIST_BOX|WEL_MULTIPLE_SELECTION_LIST_BOX]] }}

View File

@@ -0,0 +1,8 @@
[[Property:title|WEL_TOOLTIP]]
[[Property:weight|13]]
A [[ref:libraries/wel/reference/wel_tooltip_chart|WEL_TOOLTIP]] is an encapsulation of the Win32 tooltip control, and controls pop-up windows which display text. Each tooltip may control multiple pop-up windows, which are added to the tooltip using <eiffel>add_tool</eiffel>.
==Appearance==
[[Image:wel-tooltip|wel_tooltip]]

View File

@@ -0,0 +1,13 @@
[[Property:title|WEL_TRACK_BAR]]
[[Property:weight|14]]
A [[ref:libraries/wel/reference/wel_track_bar_chart|WEL_TRACK_BAR]] control has a sliding pointer and optional tick marks.
==Appearance==
A [[ref:libraries/wel/reference/wel_track_bar_chart|WEL_TRACK_BAR]] created with <eiffel>make_horizontal</eiffel>. <br/>
[[Image:wel-track-bar-horizontal|wel_track_bar_horizontal]] <br/>
<br/>
A [[ref:libraries/wel/reference/wel_track_bar_chart|WEL_TRACK_BAR]] created with <eiffel>make_vertical</eiffel>. <br/>
[[Image:wel-track-bar-vertical|wel_track_bar_vertical]]

View File

@@ -0,0 +1,21 @@
[[Property:title|WEL Interface Content]]
[[Property:weight|1]]
WEL is an encapsulation of the Win32 Application Programming Interface (API), and provides users with a powerful means of creating Win32 Applications.
==Components==
The WEL library includes the following clusters:
* [[Wel: Windows|windows]] cluster containing classes representing available windows types
* [[Controls|controls]] cluster containing classes representing available controls
* [[Standard Dialogs|stddlgs]] cluster containing classes representing standard Win32 dialogs
* <eiffel>consts</eiffel> cluster which contains constants used by WEL
* <eiffel>gdi</eiffel> cluster which contains classes allowing access to WIN32 Graphics Device Interfaces
* <eiffel>gdistock</eiffel> cluster which contains standard Graphic Device Interfaces used by WEL
* <eiffel>messages</eiffel> cluster which contains classes encapsulating windows messages
* <eiffel>shared</eiffel> cluster which contains classes encapsulating system wide shared
* <eiffel>structs</eiffel> cluster which contains classes for data structures required by Win32
* <eiffel>support</eiffel> cluster which contains many supporting classes

View File

@@ -0,0 +1,14 @@
[[Property:title|Standard Dialogs]]
[[Property:link_title|stddlgs cluster]]
[[Property:weight|2]]
This cluster contains different standard dialogs provided by WEL as listed below:
* [[WEL_CHOOSE_COLOR_DIALOG|WEL_CHOOSE_COLOR_DIALOG]]
* [[WEL_CHOOSE_FOLDER_DIALOG|WEL_CHOOSE_FOLDER_DIALOG]]
* [[WEL_CHOOSE_FONT_DIALOG|WEL_CHOOSE_FONT_DIALOG]]
* [[WEL_OPEN_FILE_DIALOG|WEL_OPEN_FILE_DIALOG]]
* [[WEL_PRINT_DIALOG|WEL_PRINT_DIALOG]]
* [[WEL_SAVE_FILE_DIALOG|WEL_SAVE_FILE_DIALOG]]

View File

@@ -0,0 +1,14 @@
[[Property:title|WEL_CHOOSE_COLOR_DIALOG]]
[[Property:weight|0]]
The [[ref:libraries/wel/reference/wel_choose_color_dialog_chart|WEL_CHOOSE_COLOR_DIALOG]] is an encapsulation of the Win32 choose color dialog, and provides a means of selecting standard colors or creating custom colors.
==Appearance==
[[Image:wel-choose-color-dialog|wel_choose_color_dialog]] <br/>
<br/>
{{seealso| '''See also''' <br/>
[[Standard Dialogs|Standard dialogs]] }}

View File

@@ -0,0 +1,14 @@
[[Property:title|WEL_CHOOSE_FOLDER_DIALOG]]
[[Property:weight|1]]
The [[ref:libraries/wel/reference/wel_choose_folder_dialog_chart|WEL_CHOOSE_FOLDER_DIALOG]] allows the directory structure to be viewed and a folder selected.
==Appearance==
[[Image:wel-choose-folder-dialog|wel_choose_folder_dialog]] <br/>
<br/>
{{seealso| '''See also''' <br/>
[[Standard Dialogs|Standard dialogs]] }}

View File

@@ -0,0 +1,14 @@
[[Property:title|WEL_CHOOSE_FONT_DIALOG]]
[[Property:weight|2]]
The [[ref:libraries/wel/reference/wel_choose_font_dialog_chart|WEL_CHOOSE_FONT_DIALOG]] is an encapsulation of the Win32 choose font dialog, and provides a means of selecting a font available on the system.
==Appearance==
[[Image:wel-choose-font-dialog|wel_choose_font_dialog]] <br/>
<br/>
{{seealso| '''See also''' <br/>
[[Standard Dialogs|Standard dialogs]] }}

View File

@@ -0,0 +1,15 @@
[[Property:title|WEL_OPEN_FILE_DIALOG]]
[[Property:weight|3]]
The [[ref:libraries/wel/reference/wel_open_file_dialog_chart|WEL_OPEN_FILE_DIALOG]] is an encapsulation of the Win32 open file dialog, and provides a means of specifying a file to be opened.
==Appearance==
[[Image:wel-open-file-dialog|wel_open_file_dialoG]] <br/>
<br/>
{{seealso| '''See also''' <br/>
[[Standard Dialogs|Standard dialogs]] <br/>
[[WEL_SAVE_FILE_DIALOG|WEL_SAVE_FILE_DIALOG]] }}

View File

@@ -0,0 +1,14 @@
[[Property:title|WEL_PRINT_DIALOG]]
[[Property:weight|4]]
The [[ref:libraries/wel/reference/wel_print_dialog_chart|WEL_PRINT_DIALOG]] is an encapsulation of the Win32 print dialog and provides a means of specifying print preferences.
==Appearance==
[[Image:wel-print-dialog|wel_print_dialog]] <br/>
<br/>
{{seealso| '''See also''' <br/>
[[Standard Dialogs|Standard dialogs]] }}

View File

@@ -0,0 +1,15 @@
[[Property:title|WEL_SAVE_FILE_DIALOG]]
[[Property:weight|5]]
The [[ref:libraries/wel/reference/wel_save_file_dialog_chart|WEL_SAVE_FILE_DIALOG]] is an encapsulation of the Win32 save file dialog, and provides a means of specifying a file name and location for saving.
==Appearance==
[[Image:wel-save-file-dialog|wel_save_file_dialoG]] <br/>
<br/>
{{seealso| '''See also''' <br/>
[[Standard Dialogs|Standard dialogs]] <br/>
[[WEL_OPEN_FILE_DIALOG|WEL_OPEN_FILE_DIALOG]] }}

View File

@@ -0,0 +1,21 @@
[[Property:title|Wel: Windows]]
[[Property:link_title|windows cluster]]
[[Property:weight|-1]]
This cluster contains the different types of windows available to a [[ref:/libraries/wel/reference/wel_application_chart|WEL_APPLICATION]] .
The following effective window types are available:
* [[ref:/libraries/wel/reference/wel_popup_window_chart|WEL_POPUP_WINDOW]]
* [[ref:/libraries/wel/reference/wel_modal_dialog_chart|WEL_MODAL_DIALOG]]
* [[ref:/libraries/wel/reference/wel_modeless_dialog_chart|WEL_MODELESS_DIALOG]]
* [[ref:/libraries/wel/reference/wel_mdi_frame_window_chart|WEL_MDI_FRAME_WINDOW]]
* [[ref:/libraries/wel/reference/wel_mdi_client_window_chart|WEL_MDI_CLIENT_WINDOW]]
* [[ref:/libraries/wel/reference/wel_mdi_child_window_chart|WEL_MDI_CHILD_WINDOW]]
* [[ref:/libraries/wel/reference/wel_main_dialog_chart|WEL_MAIN_DIALOG]]
* [[ref:/libraries/wel/reference/wel_frame_window_chart|WEL_FRAME_WINDOW]]
* [[ref:/libraries/wel/reference/wel_control_window_chart|WEL_CONTROL_WINDOW]]
{{note| '''Note:''' A WEL application must contain at least one window. See the WEL [[Tutorial|Tutorial]] for details of how to set up your first window within a [[ref:/libraries/wel/reference/wel_application_chart|WEL_APPLICATION]] . }}