[[oktatas:programozás:wxWidgets|< wxWidgets]]

====== wxWidgets ======
  * **Szerző:** Sallai András
  * Copyright (c) Sallai András, 2013
  * [[https://creativecommons.org/licenses/by-sa/4.0/|CC Attribution-Share Alike 4.0 International]]
  * Web: http://szit.hu

===== Ablak igazítása =====

<code cpp>
CenterOnParent();
CentreOnParent();
</code>

<code cpp>
CenterOnScreen();
CentreOnScreen();
</code>


<code cpp>
Centre();
Center();
</code>

<code cpp>
SetTitle(_("Az ablak címe"));
</code>


===== Combobox =====

<code cpp>
s = _("empty");
ComboBox1->Append(s);
</code>

Valamely részét törli. :)
<code cpp>
ComboBox1->Clear();
</code>




===== ListBox =====

==== Hozzáfűzés ====

  ListBox1->Append(wxT("Valami"));

==== Lista törlése ====

<code cpp>
ListBox1->Clear();
</code>



==== Rendezés ====
A wxListBox osztályhoz nincs rendezőmetódus, viszont be lehet állítani, hogy rendezett legyen a lista. Ez a tulajdonság viszont bugos a 2.8.x wxWidgets verzióval (Debian GNU/Linux 6.0), így ne használjuk, mert nem lesz megfelelő a rendezettség.


A listát tegyük egy wxArrayString tömbbe, ott rendezzük és tegyük vissza:

<code cpp>
wxArrayString templist;

for(int i=0; i< ListBox1->GetCount();i++)
    templist.Add(ListBox1->GetString(i));
templist.Sort();
ListBox1->Clear();
for(int i=0; i< templist.GetCount();i++)
    ListBox1->Append(templist[i]);
</code>

Vagy írjunk egy rendezőalgoritmust a lista elemeire magunk.

==== Lista adott számú eleme ====
<code cpp>
wxString s = ListBox1->GetString(index);
</code>

Az index annak az elemnek a száma, amit szeretnénk megkapni.


==== Keresés a listában ====
<code cpp>
  if(ListBox1->FindString(wxT("alma")) == wxNOT_FOUND)
      //Ami történjen, ha nincs alma a listában
</code>

==== Szelekció lekérése ====

Lekérdezzük:
<code cpp>
wxString str = ListBox1->GetStringSelection();
</code>

==== Szelekció módosítása ====


<code cpp>
ListBox1->SetString(ListBox1->GetSelection(), _("szöveg");
</code>



Figyelem! A SetStringSelection() metódust is erre találták ki, 
de valamikor minden ok nélkül nem működik. Biztos bugos:
<code cpp>
ListBox1->SetStringSelection(_("szöveg");
</code>

==== Szelekció törlése ====


<code cpp>
ReceiptsListBox->Delete(ReceiptsListBox->GetSelection());
</code>

==== Engedélyezés ====


A használat engedélyezése, vagy tiltása:

<code cpp>
ListBox1->Enable(false);
</code>

===== StaticText =====

Font beállítás:
<code cpp>
wxFont font;
font.SetPointSize(18);
statictext1->SetFont(font);
</code>

Színbeállítás 1:
<code cpp>
wxColour szin = wxColour(0, 0, 255);
statictext1->SetForegroundColour(szin);
</code>

Színbeállítás 2:
<code cpp>
statictext1->SetForegroundColour(wxColour(255,0,0));
</code>


Érték beállítása:
<code cpp>
statictext1->SetLabel(wxT("alma"));
</code>


===== TextCtrl =====

Egy TextCtrl panelra illesztése az objektum létrehozásával:
<code cpp>
wxTextCtrl *szovegdoboz = new wxTextCtrl(panel, wxID_ANY, wxT(""), wxPoint(100,100));
</code>

Így is beállíthatjuk:
<code cpp>
wxTextCtrl *szovegdoboz = new wxTextCtrl(panel, wxID_ANY);
</code>

Méret beállítása:
<code cpp>
szovegdoboz->SetSize(200, 200);
</code>

Háttérszín beállítása:
<code cpp>
szovegdoboz->SetBackgroundColour(wxColour(255,0,0));
</code>

Előtér, vagyis szöveg színe:
<code cpp>
szovegdoboz->SetForgroundColour(wxColour(0,0,255));
</code>

Stílusok beállítása (wxTE_MULTILINE):
<code cpp>
szovegdobooz = new wxTextCtrl(panel, wxID_ANY, wxT(""), 
        wxPoint(100,100), wxDefaultSize, wxTE_MULTILINE);
</code>

Több stílust is beállíthatunk a | karakterrel:
<code cpp>
wxTE_MULTILINE|wxTE_PROCESS_ENTER|wxTE_PROCESS_TAB
</code>


Érték beállítása
<code cpp>
TextCtrl1->SetValue(wxT("Tartalom"));
</code>


Ha a tabulátor billentyűvel szeretnénk a következő kontrollra lépni, akkor egy Panelra kell helyezni a kontrollokat. Frame-en nem működik.

===== ListCtrl =====

<code cpp>
wxListCtrl *kontroll;
</code>

<code>
kontroll = new wxListCtrl(panel, ID_KONTROLL, wxPoint(200,300), 
      wxDefaultSize, NULL, wxDefaultValidator, _T(""));
</code>

<code cpp>
kontroll = new wxListCtrl(panel, wxID_ANY, wxPoint(200,300),
        wxDefaultSize, wxSIMPLE_BORDER); 
</code>

Háttérszín beállítása
<code cpp>
kontroll->SetBackgroundColour(wxColour(255,0,0));
</code>

===== Konvertálás =====
A szöveg számokat tartalmaz és ezzel szeretnénk dolgozni.
==== wxString -> long ====

<code cpp>
wxString szoveg = wxT("243");
long szam;  
szoveg.ToLong(&szam);
</code>


==== wxString -> double ====
<code cpp>
wxString strszam = wxT("53.422");
double szam;
strszam.ToDouble(&szam);
</code>
 

==== int -> wxString ====

<code cpp>
wxString szoveg;
int szam = 3;

szoveg = wxString::Format(_T("%d"), szam);
</code>

==== Link ====

  * http://wiki.wxwidgets.org/Converting_everything_to_and_from_wxString


===== Fájlkezelés =====






==== Fejléc ====


<code cpp>
#include <wx/textfile.h>
</code>

==== Fájl megnyitása 1 ====

<code cpp>
    wxString FilePath = _T("adat.txt");
    wxTextFile f(FilePath);
    if(!f.Exists())
    {
        wxMessageBox(wxT("A fájl nem létezik"), wxT("Exist file"));
    }
    else
    {
        f.Open();
        f.AddLine(_T("----------"), wxTextFileType_Unix);
        f.Write();
        f.Close();
    }
</code>


==== Fájl megnyitása 2 ====

<code cpp>
wxString FilePath = _T("adat.txt");

wxTextFile f;

f.Open(FilePath);
f.AddLine(_T("----------"), wxTextFileType_Unix);
f.Write();
f.Close();

</code>
Ebben a verzióban a megnyitáskor adjuk meg, milyen állományt szeretnénk megnyitni.
Így viszont nem tudjuk ellenőrizni, hogy a fájl létezik-e.


==== Olvasás a fájl végétől az elejéig ====



<code cpp>
wxTextFile f(MachineFilePath);
wxString sz, sz2, sz3;
f.Open();
  
wxString FirstLine = f.GetFirstLine();
if(!FirstLine.IsEmpty())
{
    for ( sz = f.GetLastLine();f.GetCurrentLine() > 0;sz = f.GetPrevLine() )
    {
        ...
    }
}
</code>

==== Fájl végéhez fűzés ====

<code cpp>
    wxString FilePath = _T("adat.txt");
    wxTextFile f(FilePath);
    if(!f.Exists())
    {
        wxMessageBox(wxT("A fájl nem létezik"), wxT("Exist file"));
    }
    else
    {
        f.Open();

        f.Open(FilePath);
        f.AddLine(_T("----------"), wxTextFileType_Unix);
        f.Write();
        f.Close();
    }
</code>

==== Fájl tartalmának törlése ====

<code cpp>
f.Clear();
f.Write();
</code>

==== Fájl létrehozása ====

<code cpp>
wxString FilePath = _T("adat.txt");
wxTextFile f(FilePath);

f.Create(FilePath);
</code>

==== Olvasás a fájl elejétől a végéig ====

<code cpp>
wxString row;
wxString FilePath = _T("adat.txt");
wxTextFile f(FilePath);

if(!f.Exists())
{
     wxMessageBox(_("A fájl nemlétezik!"), _("Fájl létezésének ellenőrzése"));
     return;
}
else
{
    f.Open();
    for ( row = f.GetFirstLine();  !f.Eof(); row = f.GetNextLine() )
    {
         // Csinálunk valamit a row-val
    }
    f.Close();
}
</code>


===== Könyvtárkezelés =====


==== Könyvtár létezésének ellenőrzése ====

<code cpp>
if(!wxDirExists(_T("könyvtárútvonal")))
    //Amit teszünk ha nemlétezik
</code>

Így is lehet
<code cpp>
wxString dirpath(_T("valahol/valami"));
wxDir dir;
if(dir.Exists(dirpath))
    //Amit teszünk ha nem létezik
</code>

==== Könyvtár létrehozása ====

<code cpp>
wxMkdir(_T("konyvtarnev"), 0770);
</code>

===== Program ikon =====

==== Fejléc ====

<code cpp>
#include <wx/icon.h>
#include <wx/image.h>
#include <wx/bitmap.h>
</code>


==== Példa ====

Programikon betöltése:
<code cpp>  
wxString IconDir = _T("/usr/share/programnev/");
wxIcon FrameIcon;
wxString IconPath = IconDir + _T("programikon.png");

FrameIcon.CopyFromBitmap(wxBitmap(wxImage(IconPath)));
SetIcon(FrameIcon);
</code>

==== Programba épített xpm ====


<code cpp>
// the application icon
#if defined(__WXGTK__) || defined(__WXMOTIF__) || defined(__WXMAC__) 
//    #include "res/eidviewer.xpm"
static char *eidviewer_xpm[] = {
"32 32 5 1",
"  c None",
"a c Black",
"b c #FF0000",
"c c #FFFF00",
"d c #800000",
/* pixels */
"                d               ",
"               ddddd            ",
"     dd       ddddddd           ",
"   dddddddddddddddddddddd       ",
"  dddddddddddddddddddddddd      ",
"ddddddddddddddddddddddddddd     ",
"ddddddddddddddddddddddddddd     ",
"dddddddddddddddddddddddddd      ",
"ddddddddddddddddacccacdddd      ",
" ddddddddddddddcacccaaadddd     ",
"  dd ddddddddddccaccaccddddd    ",
"     ddddddddddcaaaaaacddddddd  ",
"      dddddddddacaccacadddddd   ",
"        ddddddddcaccacddddddddd ",
"         dddddddddddddddddddddd ",
"            ddddddddddddddddddd ",
"             ddddddddddddddddd  ",
"             dddddddddddddddd   ",
"             ddddddddddddddd    ",
"             dddd dddddddddd    ",
"             ddd  dddddddddd    ",
"                  dddddddddd    ",
"                  ddddddddddd   ",
"                   dddddddddd   ",
"aaaaccccbbbb           dddddd   ",
"aaaaccccbbbb           ddddd    ",
"aaaaccccbbbb            ddd     ",
"aaaaccccbbbb                    ",
"aaaaccccbbbb                    ",
"aaaaccccbbbb                    ",
"aaaaccccbbbb                    ",
"aaaaccccbbbb                    "};
 
#endif
</code>



==== Másik példa ====


<code cpp>
    //================= Icon ===========

    wxString IconFilePath;
    wxString ExecutablePath;
    wxStandardPaths Paths;


    ExecutablePath = Paths.GetExecutablePath();
    wxRegEx* regex = new wxRegEx(_T("/[a-z]*$"), wxRE_ADVANCED);
    regex->Replace(&ExecutablePath, _T(""));
    IconFilePath = ExecutablePath  + _T("/") + _T("icons/gnumerology.xpm");

    if( !wxFile::Exists(IconFilePath) )
        IconFilePath = _T("icons/gnumerology.xpm");

    if( !wxFile::Exists(IconFilePath) )
        IconFilePath = _T("gnumerology.xpm");


#ifndef __WXMSW__
    if( !wxFile::Exists(IconFilePath) )
        IconFilePath = _T("/usr/share/gnumerology/icons/gnumerology.xpm");
    if( !wxFile::Exists(IconFilePath) )
        IconFilePath = _T("/usr/local/gnumerology/icons/gnumerology.xpm");
#endif  //__WXMSW__

    wxIcon FrameIcon;
    FrameIcon.CopyFromBitmap(wxBitmap(wxImage(IconFilePath)));
    SetIcon(FrameIcon);
    //================= End of Icon ===========

</code>

 

===== wxFileDialog =====

Fájl párbeszédablakok

==== Fejlécfájl ====

<code cpp>
#include <wx/filedlg.h>
</code>


==== Osztály ====

wxFileDialog osztályt használjuk. A konstruktorban egy minimális paramétert szoktunk használni, amely megadja a szülőobjektumot. Ez általában this.


==== Példa ====

<code cpp>
wxFileDialog *BrowseFileDialog = new wxFileDialog(this);
BrowseFileDialog->ShowModal();
</code>


<code cpp>
if(BrowseFileDialog->ShowModal() != wxID_OK)
    return;
TextCtrl1->SetValue(BrowseFileDialog->GetFilename());
</code>






<code cpp>
wxFileDialog *filedialog = new wxFileDialog(this, _("Choose a file"), _("/default/directory"), _("defaultfile"), _("*.*"), wxFD_DEFAULT_STYLE);

filedialog->ShowModal();

</code>

A wxFD_DEFAULT_STYLE állandó helyére behelyettesíthetők más azonosítók is. Lásd alább.

==== Állandók ====

| wxFD_DEFAULT_STYLE | Megegyezik a wxFD_OPEN állandóval |
| wxFD_OPEN | Megnyitás párbeszédablak Nem kombinálható a wxFD_SAVE állandóval. |
| wxFD_SAVE | Mentés párbeszédablak. Nem kombinálható a wxFD_OPEN állandóval. |
| wxFD_OVERWRITE_PROMPT | Csak mentés. A fájl felülírásra rákérdez  |
| wxFD_FILE_MUST_EXIST | Megnyitás csak. Csak kész fájl kiválasztása |
| wxFD_MULTIPLE | Csak megnyitás. Több fájl kiválasztása is megengedett |
| wxFD_CHANGE_DIR | Az aktuális könyvtár cseréje arra, ahol a kiválasztott fájl található. |
| wxFD_PREVIEW | A kiválasztott fájlok előnézetét adja (jelenleg csak a wxGTK támogatja a GTK+ 2.4 és későbbi változatában). |


==== Teljes konstruktor ====

<code cpp>
wxFileDialog *a = new wxFileDialog(this, _("Choose a file"), _("/default/directory"), _("defaultfile"), _("*.*"), wxFD_DEFAULT_STYLE, wxDefaultPosition, wxDefaultSize, _("filedlg"));

</code>
===== wxDirDialog =====

Könyvtár párbeszédablak használata

==== Fejlécfájl ====

<code cpp>
#include <wx/dirdlg.h>
</code>

==== Példa ====

<code cpp>
wxDirDialog *BrowseDirDialog = new wxDirDialog(this);
if(BrowseDirDialog->ShowModal() == wxID_OK)
    DataSavePathTextCtrl->SetValue(BrowseDirDialog->GetPath());
</code>

===== Státuszsor =====

A státuszsor szövegének beállítása:
<code cpp>
StatusBar1->SetStatusText(_wxT("státusz szöveg"));
</code>

Ha több mezőből áll:
<code cpp>
StatusBar1->SetStatusText(_wxT("első"), 0);
StatusBar1->SetStatusText(_wxT("második"), 1);
</code>

===== Reguláris kifejezések =====

==== Fejlécállomány ====

<code cpp>
#include <wx/regex.h>
...
</code>

<code cpp>
wxString vs = _T("^([[.a.]-[.z.]]|[[.A.]-[.Z.]])+$");
wxRegEx* GoodName = new wxRegEx(vs);
if(!GoodName->Matches(FamilyName)) wxMessageBox(wxT("Az e-mail címed"));
</code>

Lehet így is:
<code cpp>
wxString vs = _T("^([[.a.]-[.z.]]|[[.A.]-[.Z.]]|-|_)+$");
</code>
Ekkor a kötőjelre és az alulvonásra is illeszkedik.


==== HTML tagek kiszedése ====

A HTML tagek kiszedése egy webforrásból:
<code cpp>
wxRegEx* regex = new wxRegEx(wxT("<.*?>"), wxRE_ADVANCED);
size_t count = regex->ReplaceAll(&htmldata, wxT(""));
</code>

Ha egy \. akarunk a reguláris kifejezésbe illeszteni, két vissza-perjel kell,
mert a C++ a vissza-perjelnek egyébként is speciális jelentése van:
<code cpp>
wxRegEx* regex = new wxRegEx(wxT("\\."), wxRE_ADVANCED);
</code>

==== Ha újra szeretnénk felhasználni a regex változót ====

<code cpp>
wxString regstr;
wxRegEx* regex = new wxRegEx();
regstr = _T("^1|4|8$");
regex->Compile(regstr);
if(regex->Matches(_T("amit_ellenőrizni_kell")))
    //Amit tenni akarunk ha egyezés van
</code>



===== Unicode használat =====
Nem csak wxWidget esetén lehet hasznos az UNICODE definiálása

<code cpp>
#define UNICODE
</code>
Mindig az #include sorok előtt legyenek.

===== Táblázat -- wxGrid =====

==== Alapbeállíátsok ====

Oszlop címke beállítása (0-dik):
<code cpp>
Grid1->SetColLabelValue(0, wxT("alma"));
</code>

Sor és oszlopcímkék elrejtése:
<code cpp>
Grid1->SetRowLabelSize(0);
Grid1->SetColLabelSize(0);
</code>



Sorok és oszlopok száma:
<code cpp>
Grid1->CreateGrid(9,9);
</code>


Szélesség, magasság állítása:
<code cpp>
//Grid1->SetRowLabelSize(10);    //Oldalt

Grid1->SetColLabelSize(50);  //felül

Grid1->SetDefaultColSize(30, true ); //oszlopok szélessége

Grid1->SetColLabelTextOrientation(wxVERTICAL); //wxHORIZONTAL Ez  az alapértelmezett
</code>


Cellafelirat beállítása
<code cpp>
Grid1->SetColLabelValue(0, _T("Valami"));
Grid1->SetRowLabelValue(1, _T("MásValami"));
</code>

Sorok hozzáadása:
<code cpp>
Grid1->AppendRows(1,true);
</code>

Oszlopok hozzáadása:
<code cpp>
Grid1->AppendCols(1,true);
</code>


<code cpp>
AppendCols(int numCols = 1, bool updateLabels = TRUE)
AppendRows(int numRows = 1, bool updateLabels = TRUE)
ClearGrid() 
DeleteCols(int pos = 0, int numCols = 1, bool updateLabels = TRUE)
DeleteRows(int pos = 0, int numRows = 1, bool updateLabels = TRUE)
GetNumberCols( )
GetNumberRows( )
InsertCols(int pos = 0, int numCols = 1, bool updateLabels = TRUE)
InsertRows(int pos = 0, int numRows = 1, bool updateLabels = TRUE)
</code>

=== Színezés ===


<code cpp>
Grid2->SetCellBackgroundColour(5, 10, wxColour(0, 0, 255)); //y, x, szín
</code>

=== Igazítás ===

  wxGrid::SetDefaultCellAlignment

  void SetDefaultCellAlignment(int horiz, int vert)

Alapértelmezett vízszintes és függőleges igazítás a cellák szövegei számára. 

Vízszintesen a következő értékeke egyike: wxALIGN_LEFT, wxALIGN_CENTRE vagy wxALIGN_RIGHT.

Függőlegesen a következő értékek egyike: wxALIGN_TOP, wxALIGN_CENTRE vagy wxALIGN_BOTTOM.

=== Font ===

  wxGrid::SetDefaultCellFont

  void SetDefaultCellFont(const wxFont& font)

Alapértelmezett font a szöveg számára a táblázatban.


=== Egyéb ===

<code cpp>
Grid2->CreateGrid(16,16); //A táblázat cellái
Grid2->SetRowLabelSize(0); //Nincs oldalcímke
Grid2->SetColLabelSize(0); //Nincs felsőcímke
Grid2->SetDefaultColSize(20); //Az oszlopok szélessége
Grid2->SetDefaultRowSize(20); //A sorok magassága
Grid2->SetSize(350, 350); //Táblázat szélessége, magassága

Grid2->SetCellBackgroundColour(5, 10, wxColour(0, 0, 255)); //y, x, szín
Grid2->SetCellTextColour(5, 10, wxColour(255,255,255)); //Szöveg színe

Grid2->SetCellAlignment(wxALIGN_CENTRE, 5, 10); //Igazítás
Grid2->SetCellValue(5, 10, _("X")); //Tartalom

Grid2->SetGridLineColour(wxColour(0,0,0)); //Szegély színe


wxFont font;
font.SetPointSize(18);
Grid2->SetDefaultCellFont(font);
</code>

A felső és bal szegély nem látszik, ezért alá szokás tenni egy wxPenel objektumot.




==== Cellaszerkesztők ====

=== Legördülő listadoboz ===

<code cpp>
wxString strChoices[3] = {_("one"), _("two"), _("three")};
Grid1->SetCellEditor(1, 1, new wxGridCellChoiceEditor(3, strChoices, true));
</code>

=== Léptetődoboz ===
<code cpp>
Grid1->SetCellEditor(1, 1, new wxGridCellNumberEditor(1,1000));
</code>

=== Jelőlőnégyzet ===
<code cpp>
Grid1->SetCellEditor(1, 1, new wxGridCellBoolEditor());
</code>

=== Törtszám ===
<code cpp>
Grid1->SetCellEditor(1, 1, new wxGridCellFloatEditor());
</code>


==== Kép a cellába ====

<code cpp>
class wxBmpCellRenderer : public wxGridCellRenderer {
public:
   wxBmpCellRenderer(const wxBitmap& bmp) : wxGridCellRenderer(), m_bmp(bmp) {}

   void   Draw(wxGrid& grid, wxGridCellAttr& attr, wxDC& dc,
                      const wxRect& rect, int row, int col, bool isSelected);

   wxSize GetBestSize(wxGrid& grid, wxGridCellAttr& attr, wxDC& dc,
         int row, int col) { return wxSize(m_bmp.GetWidth(), m_bmp.GetHeight()); }
   wxGridCellRenderer *Clone() const { return new wxBmpCellRenderer(m_bmp); }
private:
        wxBitmap m_bmp;
};

</code>


<code cpp>
void wxBmpCellRenderer::Draw(wxGrid& grid, wxGridCellAttr& attr, wxDC& dc, const wxRect& rect, int row, int col, bool isSelected)
{

     //wxColour BgColor = attr.GetBackgroundColour();

     wxColour BgColor = wxColour(255,0,0);
     dc.SetBrush(wxBrush(BgColor, wxSOLID));
     //dc.SetPen(*wxTRANSPARENT_PEN);

     dc.DrawRectangle(rect.x, rect.y, rect.width, rect.height);
     //dc.DrawRectangle(2, 2, 10, 15);



}
</code>



<code cpp>
wxString IconPath = _T("kepfajl.xpm");
Grid1->SetCellRenderer(1, 1, new wxBmpCellRenderer(wxBitmap(wxImage(IconPath))));
</code>

===== Üzenet ablak =====
==== Egyszerű üzenetablak ====
<code cpp>
wxMessageBox(wxT("Üzenet"));
</code>



==== Szükséges könyvtárak ====

<code cpp>
#include <wx/msgdlg.h>
</code>


==== Lehetséges használat ====

<code cpp>
int answer = wxMessageBox("Quit program?", "Confirm",
                          wxYES_NO | wxCANCEL, main_frame);
if (answer == wxYES)
  main_frame->Close();

</code>

A wxMessageBox utolsó paramétere nem kötelező.

==== Másik lehetséges használat ====


<code cpp>
  if(wxMessageBox(_("The file is exist! Append?"), _("Exist file"),wxYES_NO)!=wxYES)
      return;
</code>
===== Szöveg darabolása =====

<code cpp>
#include <wx/tokenzr.h>
</code>



<code cpp>
wxStringTokenizer tkz(wxT("alma:körte:barack:szilva"), wxT(":"));
while ( tkz.HasMoreTokens() )
{
    wxString token = tkz.GetNextToken();

    // Amit szeretnénk csinálni a szóval (tokennel)
}
</code>

A token változóban megkapjuk az egyes szöveg részeket, úgy mint alma, kört, stb. 
Szeparátor megadható több is, egymás után:

<code cpp>
wxStringTokenizer tkz(wxT("alma:körte:barack:szilva"), wxT(":;\t\n"));
</code>

A példában kettőspont, pontosvessző, tabulátor és sortörés is szeparátor.




===== wxAboutDialogInfo =====

<code cpp>
#include <wx/aboutdlg.h>
</code>


<code cpp>
    wxAboutDialogInfo a;
    a.AddDeveloper(_T("Sallai András"));
    a.SetCopyright(_T("Copyright (c) Sallai András, 2011"));
    a.SetLicence(_T("GNU GPL v.3"));
    a.SetVersion(_T("0.1"));
    a.SetWebSite(_T("http://szit.hu"));
    wxAboutBox(a);
</code>


===== Konfiguráció =====

==== Fejléc ====

<code cpp>
#include <wx/config.h>
</code>

==== Beállítások mentése ====

<code cpp>
wxConfig *config = new wxConfig(wxT("programnev"));
config->SetPath(wxT("CsoportNev"));

config->Write(wxT("Változó1"), wxT("érték"));
config->Write(wxT("Változó2"), wxT("érték"));

config->Flush();
delete config;
</code>

==== Beállítások betöltése ====

<code cpp>
wxConfig *config = new wxConfig(wxT("programnev"));
config->SetPath(wxT("CsoportNev"));

wxString beallitas1 = config->Read(wxT("Valtozo1"));
wxString beallitas2 = config->Read(wxT("Valtozo2"));

config->Flush();
delete config;
</code>





==== Komplexebb példa ====

<code cpp>
wxConfig *config = new wxConfig(wxT("gregistry"));
config->SetPath(wxT("MachinePosition"));

machinePosx << Machine01Panel->GetPosition().x;
machinePosy << Machine01Panel->GetPosition().y;
machinePos.Append(machinePosx);
machinePos.Append(_T("x"));
machinePos.Append(machinePosy);
config->Write(wxT("Machine01"), machinePos);

machinePos.Clear();
machinePosx.Clear();
machinePosy.Clear();
machinePosx << Machine02Panel->GetPosition().x;
machinePosy << Machine02Panel->GetPosition().y;
machinePos.Append(machinePosx);
machinePos.Append(_T("x"));
machinePos.Append(machinePosy);
config->Write(wxT("Machine02"), machinePos);

config->Flush();
delete config;

</code>

==== Programneven könyvtárba mentés ====

<code cpp>
wxConfig *config = new wxConfig(wxT("programnev/config"));
</code>


===== Eseménykezelés =====

==== Komponenshez esemény ====

<code cpp>
ComboBox2->Connect(wxEVT_LEFT_DOWN,wxMouseEventHandler(aFrame::ComboBox2OnMotion), NULL, this);
</code>

Értelmezés:
  * A ComboBox2 komponens egy eseményét szeretném figyelni.
  * Az egér LEFT_DOWN eseményére szeretnék reagálni
  * Ha az esemény bekövetkezik akkor a következő metódus hajtódjon végre: aFrame::ComboBox2OnMotion
  * Az eseménytáblában nincsenek adatok
  * A metódust this (ez az osztály hívja)





==== Eseménykezelő metódus ====

<code cpp>
void gregistryFrame::OnMotion(wxMouseEvent& event)
{
    if(event.LeftIsDown())
    {
        //Mi történjen, ha a bal egérgomb le volt nyomva.
    }

}
</code>



Az event objektumon keresztül lekérdezhetjük az egér aktuális állapotát:
<code cpp>
int x = event.GetX();
int y = event.GetY();
</code>


==== Melyik objektum váltotta ki az eseményt? ====

Az eseménykezelő metódusban:
<code cpp>
if(event.GetEventObject() == ComboBox1) 
      wxMessageBox(wxT("A ComboBox1 váltott ki az eseményt"));
</code>

===== Másik Frame =====

==== Hivatkozás a másik framre ====

Sokszor szeretnénk másik Framet készíteni. Például egy beállítás frame. Legyen a főprogramunk ProgramFrame a beállítások a OptionsFrame osztályban. 

Az OptionsFrame megjelenítését a következő módon érhetem el:
<code cpp>
   OptionsFrame *optionsframe = new OptionsFrame(this, 0);
   optionsframe->Show();
</code>
Fontos a szülőparaméter beállítása: this. Az első sort ne a megjelenítést végző metódusba tegyük, mert akkor minden megjelenítés eseménynél létrejön. Tegyük az osztály egyik tagjának, amit a konstruktorban hozunk létre.

A ProgramFrame fejrészében természetesen kell egy include:
<code cpp>
#include "OptionsFrame.h"
</code>
==== Visszafele hivatkozás ====

Általában szeretnénk a másik frame-ből visszafele is hivatkozni, a hívó frame egyes objektumaira.
<code cpp>
ProgramFrame *programframe = (ProgramFrame *) this->GetParent();
</code>


Ezek után meghívhatjuk a ProgramFrame osztály metódusait, ha azok publikusak:
<code cpp>
programframe->SetProgramFrameObject(SomeParameter);
</code>





==== Billentyűzet figyelése ====

<code cpp>
FamilynameTextCtrl->Connect(wxEVT_KEY_DOWN, wxKeyEventHandler(gnumerologyFrame::OnKeyDown), NULL, this);
</code>

<code cpp>
void Board::OnKeyDown(wxKeyEvent& event)
{
    if (!isStarted || curPiece.GetShape() == NoShape) {  
        event.Skip();
        return;
    }

    int keycode = event.GetKeyCode();

    if (keycode == 'p' || keycode == 'P') {
	Pause();
        return;
    }

    if (isPaused)
        return;

    switch (keycode) {
    case WXK_LEFT:
        TryMove(curPiece, curX - 1, curY);
        break;
    case WXK_RIGHT:
        TryMove(curPiece, curX + 1, curY);
        break;
    case WXK_DOWN:
        TryMove(curPiece.RotateRight(), curX, curY);
        break;
    case WXK_UP:
        TryMove(curPiece.RotateLeft(), curX, curY);
        break;
    case WXK_SPACE:
        DropDown();
        break;
    case 'd':
        OneLineDown();
        break;
    case 'D':
        OneLineDown();
        break;
    default:
        event.Skip();
    }

}
</code>


<code>
    WXK_BACK    = 8
    WXK_TAB     = 9
    WXK_RETURN  = 13
    WXK_ESCAPE  = 27
    WXK_SPACE   = 32
    WXK_DELETE  = 127

    // Az alábbiak nem kompatibilisek a unicode karakterekkel. 
    // Ha key eseményből unicode karaktert szeretnél, akkor használt a következőt:
    // wxKeyEvent::GetUnicodeKey 
    WXK_START   = 300
    WXK_LBUTTON
    WXK_RBUTTON
    WXK_CANCEL
    WXK_MBUTTON
    WXK_CLEAR
    WXK_SHIFT
    WXK_ALT
    WXK_CONTROL
    WXK_MENU
    WXK_PAUSE
    WXK_CAPITAL
    WXK_END
    WXK_HOME
    WXK_LEFT
    WXK_UP
    WXK_RIGHT
    WXK_DOWN
    WXK_SELECT
    WXK_PRINT
    WXK_EXECUTE
    WXK_SNAPSHOT
    WXK_INSERT
    WXK_HELP
    WXK_NUMPAD0
    WXK_NUMPAD1
    WXK_NUMPAD2
    WXK_NUMPAD3
    WXK_NUMPAD4
    WXK_NUMPAD5
    WXK_NUMPAD6
    WXK_NUMPAD7
    WXK_NUMPAD8
    WXK_NUMPAD9
    WXK_MULTIPLY
    WXK_ADD
    WXK_SEPARATOR
    WXK_SUBTRACT
    WXK_DECIMAL
    WXK_DIVIDE
    WXK_F1
    WXK_F2
    WXK_F3
    WXK_F4
    WXK_F5
    WXK_F6
    WXK_F7
    WXK_F8
    WXK_F9
    WXK_F10
    WXK_F11
    WXK_F12
    WXK_F13
    WXK_F14
    WXK_F15
    WXK_F16
    WXK_F17
    WXK_F18
    WXK_F19
    WXK_F20
    WXK_F21
    WXK_F22
    WXK_F23
    WXK_F24
    WXK_NUMLOCK
    WXK_SCROLL
    WXK_PAGEUP,
    WXK_PAGEDOWN,

    WXK_NUMPAD_SPACE,
    WXK_NUMPAD_TAB,
    WXK_NUMPAD_ENTER,
    WXK_NUMPAD_F1,
    WXK_NUMPAD_F2,
    WXK_NUMPAD_F3,
    WXK_NUMPAD_F4,
    WXK_NUMPAD_HOME,
    WXK_NUMPAD_LEFT,
    WXK_NUMPAD_UP,
    WXK_NUMPAD_RIGHT,
    WXK_NUMPAD_DOWN,
    WXK_NUMPAD_PAGEUP,
    WXK_NUMPAD_PAGEDOWN,
    WXK_NUMPAD_END,
    WXK_NUMPAD_BEGIN,
    WXK_NUMPAD_INSERT,
    WXK_NUMPAD_DELETE,
    WXK_NUMPAD_EQUAL,
    WXK_NUMPAD_MULTIPLY,
    WXK_NUMPAD_ADD,
    WXK_NUMPAD_SEPARATOR,
    WXK_NUMPAD_SUBTRACT,
    WXK_NUMPAD_DECIMAL,
    WXK_NUMPAD_DIVIDE,
</code>

===== Dátum =====

==== Az aktuális nap lekérdezése ====

<code cpp>
wxDateTime now = wxDateTime::Now();
wxString CurrentDay = now.Format(_T("%d"));
NumberOfDayDayComboBox->SetValue(CurrentDay);
</code>



===== Színek =====

==== Fejlécfájl ====

<code cpp>
#include <wx/colour.h>
</code>

==== Színek előállítása RGB kódokkal ====
<code cpp>
wxColour(255,0,0)
</code>




===== Külső program futtatása =====

<code cpp>
wxString s = _T("espeak -ven ") + Word;
char str[100];
strcpy(str, s.mb_str().data());
system(str);
</code>

===== Tömb =====

==== wxArray ====

Ez a fejlécállomány kell:
  ??

A fejlécállományban definiáljuk a tömböt:
<code cpp>
WX_DEFINE_ARRAY_INT(int, TIntTomb);
TIntTomb *tomb;
</code>


Helyet foglalunk:
<code cpp>
tomb = new TIntTomb;
</code>

Egy számot a tömbbe teszünk:
<code cpp>
tomb->Add(35);
</code>

==== wxArrayString ====

<code cpp>
wxArrayString *gyumolcsok = new wxArrayString();

gyumolcsok->Add(wxT("alma"));
gyumolcsok->Add(wxT("körte"));
gyumolcsok->Add(wxT("barack"));
gyumolcsok->Add(wxT("szilva"));

wxString str = gyumolcsok->Item(0); //az "alma"-át adja eredményül
</code>

===== TrayIcon =====

==== Fejléc ====

<code cpp>
#include <wx/taskbar.h>
</code>


==== Példa ====

wxTaskBarIcon osztályt használjuk


<code cpp>
taskbaricon->SetIcon(ikonvaltozo);
taskbaricon->PopupMenu(menu);
</code>


<code cpp>
taskbaricon->RemoveIcon()
</code>


<code cpp>
// Felülírható:
wxMenu *MyTaskBarIcon::CreatePopupMenu()
{
    // Try creating menus different ways
    // TODO: Probably try calling SetBitmap with some XPMs here
    wxMenu *menu = new wxMenu;
    menu->Append(PU_RESTORE, _T("&Restore TBTest"));
    menu->AppendSeparator();
    menu->Append(PU_OLD_ICON, _T("&Restore Old Icon"));    
    menu->Append(PU_NEW_ICON, _T("&Set New Icon"));
    menu->AppendSeparator();
    menu->Append(PU_CHECKMARK, _T("Checkmark"),wxT(""), wxITEM_CHECK);
    menu->AppendSeparator();
    wxMenu *submenu = new wxMenu;
    submenu->Append(PU_SUB1, _T("One submenu"));
    submenu->AppendSeparator();
    submenu->Append(PU_SUB2, _T("Another submenu"));
    menu->Append(PU_SUBMAIN, _T("Submenu"), submenu);
#ifndef __WXMAC_OSX__ /*Mac has built-in quit menu*/
    menu->AppendSeparator();
    menu->Append(PU_EXIT,    _T("E&xit"));
#endif
    return menu;
}

</code>

==== Példalinkek ====

  * http://freenet.googlecode.com/svn/trunk/apps/wxFCP/demo/SysTray/systray.cpp
  * http://freenet.googlecode.com/svn/trunk/apps/wxFCP/demo/SysTray/systray.h

  * http://code.google.com/p/daodict/source/browse/trunk/daodict/src/daodict/taskbaricon.cpp
  * http://code.google.com/p/daodict/source/browse/trunk/daodict/src/daodict/taskbaricon.h

===== Környezet vizsgálata =====

==== Példa 1 ====

<code cpp>
#ifdef __WXMSW__

  //Ha Windowsos környezet

#elif __WXGTK__
  
  //Ha GTK környezet

#else

  //Ha egyik sem

#endif // __WXMSW__
</code>


==== Példa 2 ====
<code cpp>
#if defined(__WXGTK__) || defined(__WXMOTIF__) || defined(__WXMAC__) || defined(__WXMGL__) || defined(__WXX11__)
    #include "logo_connected.xpm"
#endif
</code>


==== Példa 3 ====
<code cpp>
#ifndef __WXMAC_OSX__ /*A Mac elkészíti a quit menüben. */
    menu->AppendSeparator();
    menu->Append(PU_EXIT,    _T("E&xit"));
#endif
</code>


===== Nemzetköziesítés =====



==== Forrásfájlban ====

<code cpp>
wxMessageBox(_("Üzenet"));
</code>


==== A fordítandó fájlok kinyerése ====

<code bash>
xgettext -f sources.txt -p po -o programnev.pot -L C++ -k_
</code>
==== A fordítások megadása ====


A nemzetközíesítést a wxApp osztályból származtatott osztályban kell megvalósítani.



Az osztály fejlécállományában:
<code cpp>
private:
    wxLocale locale;
</code>


<code cpp>
wxStandardPaths* paths = new wxStandardPaths;
wxString ExecutablePath = paths->GetExecutablePath();
wxString LocalePath;

wxDir d;
if(d.Exists(ExecutablePath + _T("/po")))
    LocalePath = ExecutablePath + _T("/po");
</code>


<code cpp>
locale.Init();

locale.AddCatalogLookupPathPrefix(LocalePath);
locale.AddCatalog(_T("programnev"));
</code>


<code cpp>
  locale.AddCatalog(_T("sregister"),wxLANGUAGE_HUNGARIAN,_T("UTF-8") );
</code>

==== Komplett példa ====

<code cpp>
    //Get execute Path
    wxStandardPaths* paths = new wxStandardPaths;
    wxString Path = paths->GetExecutablePath();
    //Remove from right the filename
    wxRegEx* regex = new wxRegEx(_T("/[a-z]*$"), wxRE_ADVANCED);
    regex->Replace(&Path, _T(""));

    locale.Init();

    locale.AddCatalogLookupPathPrefix(_T("/usr/share/locale"));
    locale.AddCatalogLookupPathPrefix(_T("/usr/local/gnumerology/share/locale"));
    locale.AddCatalogLookupPathPrefix(Path);
    locale.AddCatalogLookupPathPrefix(_T("po"));

    //locale.AddCatalog(_T("gnumerology"),wxLANGUAGE_HUNGARIAN,_T("UTF-8") );
    locale.AddCatalog(_T("gnumerology"));
</code>

==== Link ====

  * http://wiki.wxwidgets.org/Internationalization



===== Standard útvonalak =====

==== Bevezetés ====

wxStandardPaths osztályt használjuk

<code cpp>
#include <wx/stdpaths.h>
</code>
==== Melyik könyvtárból fut a program? ====

<code cpp>

wxString ExecutablePath;
wxStandardPaths Paths;

ExecutablePath = Paths.GetExecutablePath();
    
wxRegEx* regex = new wxRegEx(_T("/[a-z]*$"), wxRE_ADVANCED);
regex->Replace(&ExecutablePath, _T(""));

</code>

==== Adatok legjobb helye ====
<code cpp>
wxStandardPaths Paths;
wxString UserDataDir = Paths.GetUserDataDir();
</code>


==== Két operációs rendszeren a fájlnév eltávolítása====

<code cpp>
wxRegEx* regex = new wxRegEx(_T("(/[a-z]*$)|(\\B[a-z]*\\.exe$)"), wxRE_ADVANCED);
regex->Replace(&ExecutablePath, _T(""));
</code>

===== Folyamatsáv =====


Osztály: wxGauge

gauge [UK: ɡeɪdʒ] mérték


==== Metódusok ====

void SetValue(int pos):
<code cpp>
Gauge1->SetValue(50);
</code>



void SetRange(int range):
<code cpp>
Guage1->SetRAnge(120);
</code>

int GetValue() const:

<code cpp>
int a = Gauge1->GetValue();
</code>

<code cpp>
Gauge1->SetValue(Gauge1->GetValue()+5);
</code>

int GetRange() const:
<code cpp>
int a = Gauge1->GetRange();
</code>


void Pulse():
<code cpp>
Gauge1->Pulse();
</code>


===== Léptető doboz =====


spin [UK: spɪn] [US: ˈspɪn] forgat

==== Metódusok ====


void SetValue(const wxString& text):
<code cpp>
SpinCtrl1->SetValue(_("alma"));
</code>


void SetValue(int value):
<code cpp>
SpinCtrl1->SetValue(5);
</code>

int GetValue() const:
<code cpp>
 int b = SpinCtrl1->GetValue();
</code>

void SetRange(int minVal, int maxVal):
<code cpp>
SpinCtrl1->SetRange(5,10);
</code>



===== Temp könyvtár =====

<code cpp>
#include <wx/stdpaths.h>

...

wxStandardPaths stdPath;
wxString tpath=stdPath.GetTempDir();

wxString tfpath;
tfpath.Append(tpath);
tfpath.Append(_("/scite_input"));
</code>

<code cpp>
wxString = wxFileName::GetPathSeparator(wxPATH_NATIVE);
</code>

A wxPATH_NATIVE azt jelenti az adott rendszer aktuális szeparátorát szeretnénk. 

Ezen kívül használhatók még a következő állandók:

  * wxPATH_UNIX
  * wxPATH_BEOS
  * wxPATH_MAC
  * wxPATH_DOS
  * wxPATH_WIN
  * wxPATH_OS2
  * wxPATH_VMS
  * wxPATH_MAX



A következő példában elkészültjük az adott rendszerben a fájlt, majd kiíratjuk a teljes útvonalat:
<code cpp>
wxString tempDir = wxStandardPaths::Get().GetTempDir(); //Az adott rendszer temp könyvtára
tempDir.Append(wxFileName::GetPathSeparator(wxPATH_NATIVE)); //Az adott rendszer útvonal szeparátorát hozzáfűzzük
wxString path = wxFileName::CreateTempFileName(tempDir,(wxFFile*)NULL); //Elkészítjük a fájlt, majd eltároljuk a teljes útvonalat.
wxMessageBox(path);
</code>


===== Komponensek helye, mozgatása =====

Egy nyomógomb mozgatásai a 20, 20 helyre:
<code cpp>
EgyButton->SetPosition(wxPoint(20,20));
</code>


A nyomógombot 3 pixellel jobbra mozdítjuk: 
<code cpp>
wxPoint pont = EgyButton->GetPosition();
pont.x = pont.x + 3;
EgyButton->SetPosition(pont);
</code>