Difference between revisions of "WxSmith tutorial: Accessing items in resource"

From Code::Blocks
m (Minor edits for clarity)
 
(16 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
[[Category:wxSmith Documentation]]
 
[[Category:wxSmith Documentation]]
 
+
= Accessing Components in a Form =
 
 
= Accessing items in a resource =
 
  
 
Welcome to the next tutorial. This time I'll show you how to access items in a resource. I'll show you some basics - for example how to read data from text boxes, change labels, and some more advanced things like changing colours and fonts while the application is running. As usual we will start with an empty application. You shouldn't have any problems with it - all instructions are in the first tutorial.
 
Welcome to the next tutorial. This time I'll show you how to access items in a resource. I'll show you some basics - for example how to read data from text boxes, change labels, and some more advanced things like changing colours and fonts while the application is running. As usual we will start with an empty application. You shouldn't have any problems with it - all instructions are in the first tutorial.
  
= Adding a few items we will work on =
+
== Setting Up the Form ==
  
 
In this tutorial we will work on items so let's add some:
 
In this tutorial we will work on items so let's add some:
Line 12: Line 10:
 
[[Image:wxs_tut06_001.png]]
 
[[Image:wxs_tut06_001.png]]
  
In this resource wxFlexGridSizer with 2 columns is used as background. In the first three rows we have wxStaticText, wxTextCtrl and wxGauge - we will operate on them using buttons in the right column. Below there is wxSlider which will be used to change the size of the font - I've changed its '''Max''' property to 30 to limit the size range. Below there's a button which will be used to change the colours of some items.
+
In this form, there is a wxBoxSizer, and in it a wxPanel, and on the panel, a wxFlexGridSizer with 2 columns, both growable (to achieve this enter “0,1” (without the quotes) in the Growable Cols property of the sizer, indicating columns 0 and 1). The following array shows which widgets are where in the window.
 +
<pre>
 +
wxStaticText wxButton
 +
wxTextCtrl wxButton
 +
wxGauge wxButton
 +
wxStaticText wxSlider
 +
wxStaticText wxButton
 +
</pre>
 +
 +
All widgets and the wxPanel behind them have their Expand property checked.
 +
 
 +
Here is what we want to make the buttons do:
 +
*The button in the first row will change the text in the static text left of it.
 +
*The button in the second row will read whatever text the user has written into the TextCtrl left of it and display that text in a message box.
 +
*The button in the third row will advance the gauge to the left of it by one tenth of the distance across the gauge, thus simulating a typical progress bar. 
 +
*Moving the slider in the fourth row will change the size of the font in the static text just left of it.  
 +
* A click on the button in the bottom row will allow the user to change the color of the text in the StaticText control just left of it.
  
= Accessing items through members of resource class =
+
== Accessing Components through their Member Functions ==
  
If you add item in editor, in most cases wxSmith will add new member variable into resource's c++ class. All those members are listed inside <code>//(*Declarations ... //*)</code> code blocks. In case of window we crated it should look like this:
+
If you add an item to the form in the editor, in most cases wxSmith will add a new member variable into the form's C++ class. All those members are listed in the header file, in our present case, the file ''Tutorial_6Main.h''. They are between wxSmith's special comments:  ''//(*Declarations...''  and  ''//*)''. The list  should look like this:
  
...
+
<pre>
class Tutorial_6Frame: public wxFrame
+
...
{
+
class Tutorial_6Frame: public wxFrame
    ...
+
{
+
    ...
        //(*Declarations(Tutorial_6Frame)
 
        wxSlider* Slider1;
 
        wxButton* Button4;
 
        wxStaticText* StaticText2;
 
        wxButton* Button1;
 
        wxGauge* Gauge1;
 
        wxStaticText* StaticText1;
 
        wxStaticText* StaticText3;
 
        wxButton* Button2;
 
        wxButton* Button3;
 
        wxStatusBar* StatusBar1;
 
        wxTextCtrl* TextCtrl1;
 
        //*)
 
    ...
 
};
 
...
 
  
Each item which has such member variable will also have following properties:
+
        //(*Declarations(Tutorial_6Frame)
* '''Var name''' - name of used variable
+
        wxSlider* Slider1;
* '''Is member''' - switch whether this item should be accessible through class member variable
+
        wxButton* Button4;
 +
        wxStaticText* StaticText2;
 +
        wxButton* Button1;
 +
        wxGauge* Gauge1;
 +
        wxStaticText* StaticText1;
 +
        wxStaticText* StaticText3;
 +
        wxButton* Button2;
 +
        wxButton* Button3;
 +
        wxStatusBar* StatusBar1;
 +
        wxTextCtrl* TextCtrl1;
 +
        //*)
 +
    ...
 +
};
 +
...
 +
</pre>
 +
Each component which has such a member variable will also have the following properties:
 +
* '''Var name''' - name of the used variable
 +
* '''Is member''' - switch whether this item should be accessible through a class member variable
  
So if you want to change name used to access item, '''Var name''' is right property to change.
+
So if you want to change the name used to access the item, '''Var name''' is the right property to change.
  
wxSmith forces few restrictions on variable names. Most obvious is that each variable name must be valid c++ identifier so you can not provide special characters or even spaces. Another limitations is that variable names must be unique.
+
wxSmith forces a few restrictions on variable names. The most obvious is that each variable name must be a valid C++ identifier, so you cannot use special characters or even spaces. Another limitation is that variable names must be unique.
If name is invalid, wxSmith will automatically replace it with name that matches criteria.
 
  
= Changing label in wxStaticText =
+
If the name is invalid, wxSmith will automatically replace it with a name that matches the criteria.
  
Ok, let's do some basic excercise by changing label of first wxStaticText. To do this double click on button next to it to generate event handler and change the code to following thing:
+
== Changing the Label in wxStaticText ==
  
 +
Let's do a basic exercise. When we click the “Change label” button, we want the program to change the label of the first wxStaticText control to “Label changed”. To make it do so, double click on the button to generate an event handler and change the code to the following:
  
void Tutorial_6Frame::OnButton1Click(wxCommandEvent& event)
+
<pre>
{
+
void Tutorial_6Frame::OnButton1Click(wxCommandEvent& event)
    StaticText1->SetLabel(_("Label changed"));
+
{
    Layout();
+
    StaticText1->SetLabel(_("Label changed"));
}
+
    Layout();
 +
}
 +
</pre>
  
In first line of function body we used '''SetLabel()''' function to change text of label. Because length of the text changes, we must recalculate positions which is done by calling '''Layout()''' function.
+
In the first line of the function body, we used the '''SetLabel()''' function to change the text of the label. Because the length of the text changes, we must recalculate positions, which is done by calling the '''Layout()''' function.
  
In case of static items (those which can't be changed by user) usually have two functions: GetLabel and SetLabel which read and write content presented by this item.
+
Static items (those which can't be changed by the user) usually have two functions: GetLabel and SetLabel which read and write content presented by this item.
  
  
You may wonder why we used some weird notation for string:
+
You may wonder why we used some weird notation for the string:
 
  _("Label changed")
 
  _("Label changed")
instead of simple
+
instead of a simple
 
  "Label changed"
 
  "Label changed"
  
There are two advantages of such approach:
+
There are two advantages of this device:
* By adding _(...) around our string we prepare our application for translation process. wxWidgets can help developing multilanguage applications and when some some different language will be used, it will automatically search for translaction of "Label changed" text in strings database.
+
* By adding _(...) around our string we prepare our application for the translation process. wxWidgets can help in developing multi-language applications. When a translation is being made, wxWidgets will automatically search for the translation of the phrase  "Label changed" in a database of equivalent strings in the source and target languages.  
* wxWidgets may be provided in two versions: with unicode support and without it (ansi build). In case of unicode version, we would have to use unicode strings: '''L"Label changed"''' and in case of ansi version we would have to use standard string notation: '''"Label changed"'''. Using '''_(...)''' macro grants that no matter what wxWidgets version is used, it will always produce proper code.
 
  
There's alternative version of string macro which works simillarily to _(...) which is written in form _T(...) or wxT(...). It works like _() one but the string is never translated.
+
* wxWidgets may be provided in two versions: with Unicode support and without it (ANSI build). In the case of a Unicode version, we would have to use Unicode strings: '''L"Label changed"''' and in case of the ANSI version we would have to use standard string notation: '''"Label changed"'''. Using the '''_(...)''' macro insures that no matter what wxWidgets version is used, it will always produce the proper code.
  
= Reading value from wxTextCtrl =
+
There's an alternative version of the string macro which works similarly to _(...) which is written in the form _T(...) or wxT(...). It works like the _() one but the string is never translated.
  
Now let's read something that's written by user. We will use wxTextCtrl (with variable TextCtrl1) for this and show the text using standard message box. Let's double click the '''Read text''' button and change the code to following:
+
== Reading the Value from wxTextCtrl ==
  
void Tutorial_6Frame::OnButton2Click(wxCommandEvent& event)
+
Now let's read something that's written by the user. We will use the wxTextCtrl (with variable TextCtrl1) for this and show the text using a standard message box. Let's double click the '''Read text''' button and change the code to the following:
{
 
    wxString Text = TextCtrl1->GetValue();
 
    wxMessageBox(_("User entered text:\n") + Text);
 
}
 
  
In the first line we read value from TextCtrl and store it inside variable of type wxString. wxString is wxWidgets implementation of string object and this library uses it as base for string representation.
+
<pre>
 +
void Tutorial_6Frame::OnButton2Click(wxCommandEvent& event)
 +
{
 +
    wxString Text = TextCtrl1->GetValue();
 +
    wxMessageBox(_("User entered text:\n") + Text);
 +
}
 +
</pre>
  
In the second line we call '''wxMessageBox''' function which shows standard message box just like it was modal dialog.
+
In the first line, we read the value from the TextCtrl and store it in a variable called Text and of the type wxString. wxString is the wxWidgets implementation of a string class and this library uses it as a base for string representation.
  
Usually items which provide content entered by user have two member functions: GetValue and SetValue. You can use them to read and write content of such item.
+
In the second line, we call the '''wxMessageBox''' function which shows a standard message box just as if it were a modal dialog.
  
= Changing value of wxGauge =
+
Usually items which provide content entered by the user have two member functions: GetValue and SetValue. You can use them to read and write the content of such items.
  
Now let's mix reading and writing of item's value on one function. We will use wxGauge for this. We will use it's two member functions: GetValue and SetValue. I've written ealier that those functions usually exist in items where user can enter some value. Well it's not a gold rule and there are exceptions from it like in case of this item :).
+
== Changing the value of wxGauge ==
  
Ok, let's add handler for third button:
+
Now let's combine reading and writing of a component's value in one function. We will use wxGauge for this. We will use it's two member functions: GetValue and SetValue. I've written earlier that those functions usually exist in items where the user can enter some value. Well, that rule is not without exceptions as we will now see as we write the handler for the third button. Double click the button and fill in the handler as follows:
  
 
  void Tutorial_6Frame::OnButton3Click(wxCommandEvent& event)
 
  void Tutorial_6Frame::OnButton3Click(wxCommandEvent& event)
Line 105: Line 123:
 
  }
 
  }
  
In first line we generate new value of progress by reading current one and adding 10 to it. In second line we prevent the value from getting out of range (by default wxGauge has range set to 0..100 - this can be changed in properties). In third line we write new value into gauge.
+
In the first line, we generate a new progress value by reading the current one and adding 10 to it. In the second line, we prevent the value from getting out of range. (By default, wxGauge has a range set to 0...100. These values can be changed in the Properties browser.) In the third line, we write the new value into the gauge.
  
= Using value from wxSlider to change font size =
+
== Using the Value from wxSlider to Change Font Size ==
  
Now let's do something more advanced. In our resource there's wxSlider and text saying that it changes font size. We will change font of this label. But we will have to update font size in two steps:
+
Now let's do something more advanced. In our resource there is a wxSlider and text saying that it changes font size. We will change the font of this label. But we will have to update the font size in two steps:
  
* As long as user draggs the slider we should change font size only
+
* As long as the user drags the slider we should change the font size only
* When user finishes dragging we should layout window because size of text changes
+
* When the user finishes dragging we should layout the window because the size of the text changes
  
wxSlider provides two events that can be used right for this purpose. First is '''EVT_COMMAND_SCROLL_THUMB_TRACK''' which is fired while dragging the slider. Second is '''EVT_COMMAND_SCROLL_THUMB_RELEASE''' which is fired when user finishes dragging.
+
wxSlider provides two events that can be used precisely for this purpose. The first is '''EVT_COMMAND_SCROLL_THUMB_TRACK''' which is fired while dragging the slider. The second is '''EVT_COMMAND_SCROLL_THUMB_RELEASE''' which is fired when the user finishes dragging.
  
Because we use events which are not default we would have to add them through properties browser. You can switch between editing standard properties and events by clicking on buttons at the top of browser:
+
Because we are using events which are not default for the slider, double clicking on the slider will not work -- as it did with buttons -- to create a frame for the handler. We have to add the two handlers through the Properties browser. You can switch between editing standard properties and editing  events by clicking on buttons at the top of browser:
  
 
[[Image:wxs_tut06_002.png]].
 
[[Image:wxs_tut06_002.png]].
  
If you switch to events, search for required events and choose '''Add new handler''' from drop-down list.
+
When you have switched to events, search for the required events and choose '''Add new handler''' from the drop-down list.
Here's the code for '''EVT_COMMAND_SCROLL_THUMB_TRACK''' handler:
+
 
 +
Here's the code for the '''EVT_COMMAND_SCROLL_THUMB_TRACK''' handler:
  
 
  void Tutorial_6Frame::OnSlider1CmdScrollThumbTrack(wxScrollEvent& event)
 
  void Tutorial_6Frame::OnSlider1CmdScrollThumbTrack(wxScrollEvent& event)
Line 130: Line 149:
 
  }
 
  }
  
Here we get font used by StaticText control by using '''GetFont()''' function, change font's size by using '''GetPointSize()''' and write font back by using '''SetFont()''' function. '''GetFont()''' and '''SetFont()''' are available in most items.
+
Here we get the font used by the StaticText control by using the '''GetFont()''' function, change the font's size by using '''SetPointSize()''' and write the font back by using the '''SetFont()''' function. '''GetFont()''' and '''SetFont()''' are available for most components.
  
 
Now let's code '''EVT_COMMAND_SCROLL_THUMB_RELEASE''':
 
Now let's code '''EVT_COMMAND_SCROLL_THUMB_RELEASE''':
Line 141: Line 160:
 
  }
 
  }
  
In the first line we adopt positions of items to new environment just like in case of changing label in wxStaticText. In the second line we recalculate minimal size of the window making sure that all items will have enough space.
+
In the first line, we adapt the positions of items to the new font size just as in the case of changing the label in wxStaticText. In the second line, we recalculate the minimal size of the window making sure that all items will have enough space.
 +
 
 +
(''Use Panel1->GetSizer()->SetSizeHints(this);for the second line in the above statement, where Panel1 is the name of the base panel in your frame.The original code, rather than resize to the new required size, just resizes to the original, default size.[[User:Ensnarer|Ensnarer]] 03.08.2015'')
  
= Changing item's colour =
+
== Changing a Component's Color ==
  
Last thing we will do in this tutorial is to change colour of some item. As in case of fonts we will change label on the left side of '''Change''' button. Since we will use standard event of this button, we can add event handler by double-clicking on it. And here's the code:
+
The last thing we will do in this tutorial is to change the color of some item. As in the case of fonts we will change the label on the left side of the '''Change''' button. Since we will use the standard event of this button, we can add an event handler by double-clicking on it. And here's the code:
  
 
  void Tutorial_6Frame::OnButton4Click(wxCommandEvent& event)
 
  void Tutorial_6Frame::OnButton4Click(wxCommandEvent& event)
Line 155: Line 176:
 
     {
 
     {
 
         StaticText3->SetForegroundColour(NewColour);
 
         StaticText3->SetForegroundColour(NewColour);
 +
        Refresh();
 
     }
 
     }
 
  }
 
  }
  
At the beginning we read current colour to variable '''OldColour'''. In next lie we call '''wxGetColourFromUser''' function which opens dialog where we can choose colour.  
+
(wxWidets originated in Edinburgh and therefore uses some quaint spellings going back to Anglo-Norman times.) At the beginning we read the current color into the variable '''OldColour'''. In the next line, we call the '''wxGetColourFromUser''' function which opens a dialog where the user can choose a colour.  
 +
 
 +
At the end, we set the new colour by using the '''SetForegroundColour''' function. Refresh is needed to change colour after setting it.
 +
 
 +
If, however, you try to compile this code, you will get an error message telling you that  wxGetColourFromUser() is an unknown function. Since we put it in manually, we must also put in manually its header. So open the Tutorial_6Main.h file and add #include <wx/colordlg.h>.
 +
 
 +
The NewColour.IsOk() call is used because if the user cancels the colour selection it will return false.
 +
But on the Ubuntu Linux 11.10 installation of wxWidgets, the wxColour class did not have an IsOk() funtion, so in fact you must remove this call. According to wxWidgets documentation, the wxColour class '''does''' indeed have the IsOk() member function, but it was not found. 
 +
 
 +
(FIXING: For get the code in the previous handler worked, just replace that on to:
 +
 
 +
<code>wxColour OldColour = StaticText3->GetForegroundColour();</code>
 +
 
 +
<code>wxColourData dc;</code>
 +
 
 +
<code>dc.SetColour(OldColour);</code>
 +
 
 +
<code>wxColourDialog clrdlg(this,&dc);</code>
 +
 
 +
<code>if ( clrdlg.ShowModal() == wxID_OK )</code>
 +
 
 +
<code>{</code>
 +
 
 +
<code>   StaticText3->SetForegroundColour(clrdlg.GetColourData().GetColour());</code>
 +
 
 +
<code>   Refresh();</code>
  
The '''NewColour.IsOk()''' call is required because if user cancels colour selection it will return false.
+
<code>}</code>
  
At the end we set new colour by using '''SetForegroundColour''' function.
+
)
 +
== More information ==
  
Header file to include in the tut....main.h file: '''#include <wx/colordlg.h>'''
+
We've reached the end of this tutorial. I showed only a few operations on typical components; there is much more you can do. For more details you can check wxWidgets' documentation available [http://www.wxwidgets.org/manuals/stable/wx_contents.html here].
  
= More informations =
+
----
  
We reached end of this tutorial. I showed only few operations on items and there's much more you can do. For more details you can check wxWidgets' documentation available [http://www.wxwidgets.org/manuals/stable/wx_contents.html here].
+
<center>'''[[WxSmith tutorial: Using wxPanel resources|Previous]] | [[WxSmith tutorials|Index]] | [[WxSmith tutorial: Creating items with custom paint and mouse handling|Next]]'''</center>

Latest revision as of 09:53, 24 September 2023

Accessing Components in a Form

Welcome to the next tutorial. This time I'll show you how to access items in a resource. I'll show you some basics - for example how to read data from text boxes, change labels, and some more advanced things like changing colours and fonts while the application is running. As usual we will start with an empty application. You shouldn't have any problems with it - all instructions are in the first tutorial.

Setting Up the Form

In this tutorial we will work on items so let's add some:

Wxs tut06 001.png

In this form, there is a wxBoxSizer, and in it a wxPanel, and on the panel, a wxFlexGridSizer with 2 columns, both growable (to achieve this enter “0,1” (without the quotes) in the Growable Cols property of the sizer, indicating columns 0 and 1). The following array shows which widgets are where in the window.

wxStaticText 		wxButton
wxTextCtrl		wxButton
wxGauge			wxButton
wxStaticText		wxSlider
wxStaticText 		wxButton

All widgets and the wxPanel behind them have their Expand property checked.

Here is what we want to make the buttons do:

  • The button in the first row will change the text in the static text left of it.
  • The button in the second row will read whatever text the user has written into the TextCtrl left of it and display that text in a message box.
  • The button in the third row will advance the gauge to the left of it by one tenth of the distance across the gauge, thus simulating a typical progress bar.
  • Moving the slider in the fourth row will change the size of the font in the static text just left of it.
  • A click on the button in the bottom row will allow the user to change the color of the text in the StaticText control just left of it.

Accessing Components through their Member Functions

If you add an item to the form in the editor, in most cases wxSmith will add a new member variable into the form's C++ class. All those members are listed in the header file, in our present case, the file Tutorial_6Main.h. They are between wxSmith's special comments: //(*Declarations... and //*). The list should look like this:

...
class Tutorial_6Frame: public wxFrame
{
    ...

        //(*Declarations(Tutorial_6Frame)
        wxSlider* Slider1;
        wxButton* Button4;
        wxStaticText* StaticText2;
        wxButton* Button1;
        wxGauge* Gauge1;
        wxStaticText* StaticText1;
        wxStaticText* StaticText3;
        wxButton* Button2;
        wxButton* Button3;
        wxStatusBar* StatusBar1;
        wxTextCtrl* TextCtrl1;
        //*)
    ...
};
...

Each component which has such a member variable will also have the following properties:

  • Var name - name of the used variable
  • Is member - switch whether this item should be accessible through a class member variable

So if you want to change the name used to access the item, Var name is the right property to change.

wxSmith forces a few restrictions on variable names. The most obvious is that each variable name must be a valid C++ identifier, so you cannot use special characters or even spaces. Another limitation is that variable names must be unique.

If the name is invalid, wxSmith will automatically replace it with a name that matches the criteria.

Changing the Label in wxStaticText

Let's do a basic exercise. When we click the “Change label” button, we want the program to change the label of the first wxStaticText control to “Label changed”. To make it do so, double click on the button to generate an event handler and change the code to the following:

void Tutorial_6Frame::OnButton1Click(wxCommandEvent& event)
{
    StaticText1->SetLabel(_("Label changed"));
    Layout();
}

In the first line of the function body, we used the SetLabel() function to change the text of the label. Because the length of the text changes, we must recalculate positions, which is done by calling the Layout() function.

Static items (those which can't be changed by the user) usually have two functions: GetLabel and SetLabel which read and write content presented by this item.


You may wonder why we used some weird notation for the string:

_("Label changed")

instead of a simple

"Label changed"

There are two advantages of this device:

  • By adding _(...) around our string we prepare our application for the translation process. wxWidgets can help in developing multi-language applications. When a translation is being made, wxWidgets will automatically search for the translation of the phrase "Label changed" in a database of equivalent strings in the source and target languages.
  • wxWidgets may be provided in two versions: with Unicode support and without it (ANSI build). In the case of a Unicode version, we would have to use Unicode strings: L"Label changed" and in case of the ANSI version we would have to use standard string notation: "Label changed". Using the _(...) macro insures that no matter what wxWidgets version is used, it will always produce the proper code.

There's an alternative version of the string macro which works similarly to _(...) which is written in the form _T(...) or wxT(...). It works like the _() one but the string is never translated.

Reading the Value from wxTextCtrl

Now let's read something that's written by the user. We will use the wxTextCtrl (with variable TextCtrl1) for this and show the text using a standard message box. Let's double click the Read text button and change the code to the following:

void Tutorial_6Frame::OnButton2Click(wxCommandEvent& event)
{
    wxString Text = TextCtrl1->GetValue();
    wxMessageBox(_("User entered text:\n") + Text);
}

In the first line, we read the value from the TextCtrl and store it in a variable called Text and of the type wxString. wxString is the wxWidgets implementation of a string class and this library uses it as a base for string representation.

In the second line, we call the wxMessageBox function which shows a standard message box just as if it were a modal dialog.

Usually items which provide content entered by the user have two member functions: GetValue and SetValue. You can use them to read and write the content of such items.

Changing the value of wxGauge

Now let's combine reading and writing of a component's value in one function. We will use wxGauge for this. We will use it's two member functions: GetValue and SetValue. I've written earlier that those functions usually exist in items where the user can enter some value. Well, that rule is not without exceptions as we will now see as we write the handler for the third button. Double click the button and fill in the handler as follows:

void Tutorial_6Frame::OnButton3Click(wxCommandEvent& event)
{
    int NewValue = Gauge1->GetValue()+10;
    if ( NewValue > 100 ) NewValue = 0;
    Gauge1->SetValue(NewValue);
}

In the first line, we generate a new progress value by reading the current one and adding 10 to it. In the second line, we prevent the value from getting out of range. (By default, wxGauge has a range set to 0...100. These values can be changed in the Properties browser.) In the third line, we write the new value into the gauge.

Using the Value from wxSlider to Change Font Size

Now let's do something more advanced. In our resource there is a wxSlider and text saying that it changes font size. We will change the font of this label. But we will have to update the font size in two steps:

  • As long as the user drags the slider we should change the font size only
  • When the user finishes dragging we should layout the window because the size of the text changes

wxSlider provides two events that can be used precisely for this purpose. The first is EVT_COMMAND_SCROLL_THUMB_TRACK which is fired while dragging the slider. The second is EVT_COMMAND_SCROLL_THUMB_RELEASE which is fired when the user finishes dragging.

Because we are using events which are not default for the slider, double clicking on the slider will not work -- as it did with buttons -- to create a frame for the handler. We have to add the two handlers through the Properties browser. You can switch between editing standard properties and editing events by clicking on buttons at the top of browser:

Wxs tut06 002.png.

When you have switched to events, search for the required events and choose Add new handler from the drop-down list.

Here's the code for the EVT_COMMAND_SCROLL_THUMB_TRACK handler:

void Tutorial_6Frame::OnSlider1CmdScrollThumbTrack(wxScrollEvent& event)
{
    wxFont Font = StaticText2->GetFont();
    Font.SetPointSize( Slider1->GetValue() );
    StaticText2->SetFont(Font);
}

Here we get the font used by the StaticText control by using the GetFont() function, change the font's size by using SetPointSize() and write the font back by using the SetFont() function. GetFont() and SetFont() are available for most components.

Now let's code EVT_COMMAND_SCROLL_THUMB_RELEASE:


void Tutorial_6Frame::OnSlider1CmdScrollThumbRelease(wxScrollEvent& event)
{
    Layout();
    GetSizer()->SetSizeHints(this);
}

In the first line, we adapt the positions of items to the new font size just as in the case of changing the label in wxStaticText. In the second line, we recalculate the minimal size of the window making sure that all items will have enough space.

(Use Panel1->GetSizer()->SetSizeHints(this);for the second line in the above statement, where Panel1 is the name of the base panel in your frame.The original code, rather than resize to the new required size, just resizes to the original, default size.Ensnarer 03.08.2015)

Changing a Component's Color

The last thing we will do in this tutorial is to change the color of some item. As in the case of fonts we will change the label on the left side of the Change button. Since we will use the standard event of this button, we can add an event handler by double-clicking on it. And here's the code:

void Tutorial_6Frame::OnButton4Click(wxCommandEvent& event)
{
    wxColour OldColour = StaticText3->GetForegroundColour();
    wxColour NewColour = wxGetColourFromUser(this,OldColour);

    if ( NewColour.IsOk() )
    {
        StaticText3->SetForegroundColour(NewColour);
        Refresh();
    }
}

(wxWidets originated in Edinburgh and therefore uses some quaint spellings going back to Anglo-Norman times.) At the beginning we read the current color into the variable OldColour. In the next line, we call the wxGetColourFromUser function which opens a dialog where the user can choose a colour.

At the end, we set the new colour by using the SetForegroundColour function. Refresh is needed to change colour after setting it.

If, however, you try to compile this code, you will get an error message telling you that wxGetColourFromUser() is an unknown function. Since we put it in manually, we must also put in manually its header. So open the Tutorial_6Main.h file and add #include <wx/colordlg.h>.

The NewColour.IsOk() call is used because if the user cancels the colour selection it will return false. But on the Ubuntu Linux 11.10 installation of wxWidgets, the wxColour class did not have an IsOk() funtion, so in fact you must remove this call. According to wxWidgets documentation, the wxColour class does indeed have the IsOk() member function, but it was not found.

(FIXING: For get the code in the previous handler worked, just replace that on to:

wxColour OldColour = StaticText3->GetForegroundColour();

wxColourData dc;

dc.SetColour(OldColour);

wxColourDialog clrdlg(this,&dc);

if ( clrdlg.ShowModal() == wxID_OK )

{

   StaticText3->SetForegroundColour(clrdlg.GetColourData().GetColour());

   Refresh();

}

)

More information

We've reached the end of this tutorial. I showed only a few operations on typical components; there is much more you can do. For more details you can check wxWidgets' documentation available here.


Previous | Index | Next