mirror of
https://github.com/EiffelSoftware/eiffel-org.git
synced 2026-04-09 11:39:24 +02:00
Author:admin
Date:2008-09-19T14:06:51.000000Z git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@28 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
This commit is contained in:
jfiat
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Common message hooks]]
|
||||
[[Property:weight|4]]
|
||||
[[Property:uuid|356b5211-f710-6509-3609-8d717ff425f7]]
|
||||
Each WEL library component implements a set of routines for processing the most common messages that a component receives. For example, looking at [[ref:libraries/wel/reference/wel_frame_window_chart|WEL_FRAME_WINDOW]] , you will see that there are many features which begin `on_'. Each of these features enable the user to know when a specific event has occurred, and to perform the appropriate processing as a result of this event. Most of the time, you will only be interested in a small subset of these, necessary to your program. For example, below is the code for on_paint:
|
||||
<code>
|
||||
on_paint (paint_dc: WEL_PAINT_DC; invalid_rect: WEL_RECT) is
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL Common Concepts]]
|
||||
[[Property:weight|0]]
|
||||
[[Property:uuid|f2486cae-0ce5-7360-d40f-aea5f2766ebd]]
|
||||
Some useful WEL concepts are listed below:
|
||||
* [[Inheriting WEL_APPLICATION|Inheriting WEL_APPLICATION]]
|
||||
* [[Redefining main_window|Redefining main_window]]
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Inheriting WEL_APPLICATION]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|e6b092c9-dfb1-7bf1-67fc-647d047b6a01]]
|
||||
For most WEL applications that you write, you will need to inherit [[ref:libraries/wel/reference/wel_application_chart|WEL_APPLICATION]] .
|
||||
|
||||
{{note| '''Note'''. See [[Tutorial Step 1|step1]] in the [[Tutorial|tutorial]] for a simple demonstration of how to do this }}
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Redefining `init_application']]
|
||||
[[Property:weight|2]]
|
||||
[[Property:uuid|95d9b971-7470-9191-3023-b99c22354e8f]]
|
||||
[[ref:libraries/wel/reference/wel_application_chart|WEL_APPLICATION]] contains a feature <eiffel>init_application</eiffel> which does nothing by default, but is called before the application is started. This can be redefined to execute tasks that must be performed before the application is running. A common redefinition is to allow the loading of common dll's, see [[List View|list_view]] sample for a demonstration of this technique.
|
||||
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Redefining main_window]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|f7bfd5d0-86ef-5387-ba79-5461a516bcf6]]
|
||||
When you inherit [[ref:/libraries/wel/reference/wel_application_chart|WEL_APPLICATION]] , you will need to implement the deferred feature main_window as a once function. This will be the main window of your application, and can be any descendent of [[ref:libraries/wel/reference/wel_composite_window_chart|WEL_COMPOSITE_WINDOW]] .
|
||||
|
||||
{{note| '''Note'''. See [[Tutorial Step 2|step2]] in the [[Tutorial|tutorial]] for a simple demonstration of how to do this. }}
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Controls]]
|
||||
[[Property:link_title|controls cluster]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|622aa1e2-75a6-4b2e-ac1a-44f1e7be6a3b]]
|
||||
==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.
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_CHECK_BOX_3_STATE]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|61726774-89f4-2a6f-8383-bda19e6db217]]
|
||||
[[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==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_CHECKBOX]]
|
||||
[[Property:weight|0]]
|
||||
[[Property:uuid|daed1ee2-dac2-b606-7c3c-2fdbd88f6a92]]
|
||||
A [[ref:libraries/wel/reference/wel_check_box_chart|WEL_CHECK_BOX]] control can take two states, checked or unchecked.
|
||||
|
||||
==Appearance==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_MULTIPLE_SELECTION_LIST_BOX]]
|
||||
[[Property:weight|5]]
|
||||
[[Property:uuid|9f1f5944-969a-2d44-9cea-5c4c3d316917]]
|
||||
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==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_OWNER_DRAW_BUTTON]]
|
||||
[[Property:weight|6]]
|
||||
[[Property:uuid|c17da029-c9dc-e664-86ce-53b1e3e4e2cc]]
|
||||
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==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_PROGRESS_BAR]]
|
||||
[[Property:weight|7]]
|
||||
[[Property:uuid|6c8b5b4c-2d55-9635-1c29-361c28f09b14]]
|
||||
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. }}
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_SINGLE_SELECTION_LIST_BOX]]
|
||||
[[Property:weight|12]]
|
||||
[[Property:uuid|4123c28b-da84-8d4b-5d51-844716569c44]]
|
||||
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==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL Interface Content]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|e779c244-ec00-6a80-41e6-3ff79eb1efdb]]
|
||||
WEL is an encapsulation of the Win32 Application Programming Interface (API), and provides users with a powerful means of creating Win32 Applications.
|
||||
|
||||
==Components==
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Standard Dialogs]]
|
||||
[[Property:link_title|stddlgs cluster]]
|
||||
[[Property:weight|2]]
|
||||
[[Property:uuid|0af8dcbf-ed31-51d7-885c-c677090f0633]]
|
||||
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]]
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_CHOOSE_COLOR_DIALOG]]
|
||||
[[Property:weight|0]]
|
||||
[[Property:uuid|d827c9d8-068b-bade-f6a5-6aeb6be145e3]]
|
||||
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==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_CHOOSE_FOLDER_DIALOG]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|cd4eaeb8-2322-e95f-0528-75ec0849d0fe]]
|
||||
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==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_CHOOSE_FONT_DIALOG]]
|
||||
[[Property:weight|2]]
|
||||
[[Property:uuid|046ecb0d-819b-fbc5-d736-629d0497b8b5]]
|
||||
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==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_OPEN_FILE_DIALOG]]
|
||||
[[Property:weight|3]]
|
||||
[[Property:uuid|b97583e1-ecfd-d2c0-2718-cc7bb90c9ec7]]
|
||||
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==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_PRINT_DIALOG]]
|
||||
[[Property:weight|4]]
|
||||
[[Property:uuid|c6c2866e-c14a-601c-8898-845c4b8d92a3]]
|
||||
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==
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL_SAVE_FILE_DIALOG]]
|
||||
[[Property:weight|5]]
|
||||
[[Property:uuid|db6de1e7-1edb-3968-6ee5-60bf5d6f75cb]]
|
||||
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==
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Wel: Windows]]
|
||||
[[Property:link_title|windows cluster]]
|
||||
[[Property:weight|-1]]
|
||||
[[Property:uuid|dc1af280-2e91-713c-751f-e88ce87197cf]]
|
||||
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:
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Bmpview]]
|
||||
[[Property:weight|-15]]
|
||||
[[Property:uuid|c3df2d26-d913-e298-c7bc-929451617903]]
|
||||
[[Image:bmpview|bmpview]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Brushes]]
|
||||
[[Property:weight|-14]]
|
||||
[[Property:uuid|6bca9e95-d5fe-3b88-bea0-284eb60d2dcf]]
|
||||
[[Image:brushes|brushes]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Commands]]
|
||||
[[Property:weight|-12]]
|
||||
[[Property:uuid|e1942cb8-02df-352e-061c-2c87c280ead8]]
|
||||
[[Image:commands|commands]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Wel Sample: Controls]]
|
||||
[[Property:link_title|Controls Sample]]
|
||||
[[Property:weight|-11]]
|
||||
[[Property:uuid|7f9a091f-61af-9ea2-18c3-469573ba14f3]]
|
||||
[[Image:controls|controls]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Hello World]]
|
||||
[[Property:link_title|Hello World!]]
|
||||
[[Property:weight|-4]]
|
||||
[[Property:uuid|37b82651-78e9-dd6a-97bf-0fe3c444157d]]
|
||||
[[Image:hello|hello]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|WEL Samples]]
|
||||
[[Property:weight|4]]
|
||||
[[Property:uuid|f6df9869-52b7-0d10-dd0c-52796f631998]]
|
||||
There are a large number of samples provided with the WEL library, each designed to demonstrate different functionality. The samples available are listed below:
|
||||
* [[Tutorial|Tutorial]]
|
||||
{{note| '''Note''': If you are new to WEL programming, this is the recommended place to start. }}
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|List View]]
|
||||
[[Property:weight|-3]]
|
||||
[[Property:uuid|709475e9-e01c-6ce7-942f-7dc6bf6f3bec]]
|
||||
[[Image:list-view|list_view]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|MDI (Multiple Document Interface)]]
|
||||
[[Property:weight|-1]]
|
||||
[[Property:uuid|e5f4b1d5-31a1-51a3-46ea-3cf70a4b40d7]]
|
||||
[[Image:mdi--mdi|mdi]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Minimal]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|270db90c-dc2a-b6c4-8c2d-62a6657d01de]]
|
||||
[[Image:minimal|minimal]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Printer]]
|
||||
[[Property:weight|3]]
|
||||
[[Property:uuid|ee50d48e-4f39-adbc-1f69-1f9d9ef6e101]]
|
||||
[[Image:printer|printer]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Rich Edit]]
|
||||
[[Property:weight|4]]
|
||||
[[Property:uuid|d0a35ffd-a253-406f-ba15-c78400e8acd5]]
|
||||
[[Image:richedit|richedit]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Split Area]]
|
||||
[[Property:weight|5]]
|
||||
[[Property:uuid|b53ef206-7cda-5f27-649c-e43b47688061]]
|
||||
[[Image:splitarea|splitarea]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Wel Sample: Standard Dialogs]]
|
||||
[[Property:link_title|Standard Dialogs Sample]]
|
||||
[[Property:weight|6]]
|
||||
[[Property:uuid|0d706af1-8c76-64b3-5907-0d9effb2bb8f]]
|
||||
[[Image:stddlgs|stddlgs]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Wel Sample: Tree View]]
|
||||
[[Property:link_title|Tree View Sample]]
|
||||
[[Property:weight|8]]
|
||||
[[Property:uuid|31c64f11-3aa4-cfff-b9f3-09027acfc143]]
|
||||
[[Image:tree-view--tree-view|tree_view]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Wel Sample: Unicode]]
|
||||
[[Property:link_title|Unicode Sample]]
|
||||
[[Property:weight|9]]
|
||||
[[Property:uuid|9905de6c-3f13-1c31-2f8c-efddd71abc6d]]
|
||||
[[Image:unicode|unicode]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Wel Sample: Windows]]
|
||||
[[Property:link_title|Windows Sample]]
|
||||
[[Property:weight|10]]
|
||||
[[Property:uuid|3ace1338-c85b-c7d8-faaf-52e9fb4e157e]]
|
||||
[[Image:windows|windows]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|XY Co-ordinates]]
|
||||
[[Property:weight|12]]
|
||||
[[Property:uuid|f0b46125-2954-1504-0f47-c023462957f3]]
|
||||
[[Image:xy|xy]] <br/>
|
||||
<br/>
|
||||
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
[[Property:title|Tutorial]]
|
||||
[[Property:link_title|WEL Tutorial]]
|
||||
[[Property:weight|2]]
|
||||
[[Property:uuid|68faa545-c658-ad5e-ca6f-ab693a7aabf8]]
|
||||
WEL is shipped with a tutorial among its sample programs. This tutorial shows you how to develop a simple WEL application and contains eight different samples listed below:
|
||||
* [[Tutorial Step 1|Step1]] - A Basic WEL Application.
|
||||
* [[Tutorial Step 2|Step2]] - Responding to an event.
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Tutorial Step 1]]
|
||||
[[Property:weight|0]]
|
||||
[[Property:uuid|b952d232-1ef9-04a8-bac4-117185aa316d]]
|
||||
This sample shows you how to set up your first [[ref:/libraries/wel/reference/wel_application_chart|WEL_APPLICATION]] consisting of a single [[ref:/libraries/wel/reference/wel_frame_window_chart|WEL_FRAME_WINDOW]] . This is one of the simplest WEL applications you can write, and the output is shown below:
|
||||
[[Image:step1|step1]] <br/>
|
||||
<br/>
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Tutorial Step 2]]
|
||||
[[Property:weight|1]]
|
||||
[[Property:uuid|f4a73538-8a2f-ce6b-5190-6bd4d0e8c8d1]]
|
||||
This sample shows you how to respond to an event occurring within your application. It also demonstrates the use of a [[ref:libraries/wel/reference/wel_msg_box_chart|WEL_MSG_BOX]] control and a redefinition of closeable from [[ref:libraries/wel/reference/wel_composite_window_chart|WEL_COMPOSITE_WINDOW]] .
|
||||
[[Image:step2|step2]] <br/>
|
||||
<br/>
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Tutorial Step 3]]
|
||||
[[Property:weight|2]]
|
||||
[[Property:uuid|7d79155a-fe75-e252-49d7-b03243ac96fd]]
|
||||
This sample demonstrates the use of a [[ref:libraries/wel/reference/wel_client_dc_chart|WEL_CLIENT_DC]] to display output in the <code>MAIN_WINDOW</code>. The output is shown below:
|
||||
[[Image:step3|step3]] <br/>
|
||||
<br/>
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Tutorial Step 4]]
|
||||
[[Property:weight|3]]
|
||||
[[Property:uuid|a43c069c-d56e-47f0-f1b0-d58df627b5a4]]
|
||||
This sample builds on the knowledge learned in the previous tutorials ( [[Tutorial Step 1|1]] , [[Tutorial Step 2|2]] and [[Tutorial Step 3|3]] ) and again demonstrates the use of a [[ref:libraries/wel/reference/wel_client_dc_chart|WEL_CLIENT_DC]] .
|
||||
[[Image:step4|step4]] <br/>
|
||||
<br/>
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
[[Property:title|Tutorial Step 8]]
|
||||
[[Property:weight|7]]
|
||||
[[Property:uuid|38c3a22d-2c15-cb68-a685-99a25d191885]]
|
||||
This sample builds on tutorial [[Tutorial Step 7|step 7]] , and also demonstrates the use of a [[ref:libraries/wel/reference/wel_open_file_dialog_chart|WEL_OPEN_FILE_DIALOG]] and a [[ref:libraries/wel/reference/wel_save_file_dialog_chart|WEL_SAVE_FILE_DIALOG]] . The output is shown below:
|
||||
[[Image:step8|step8]] <br/>
|
||||
<br/>
|
||||
|
||||
Reference in New Issue
Block a user