PB069/06 Cvičení 6

Sloupcové grafy

Vytvořte program kreslící sloupcové grafy. Sloupek grafu bude představovat následující třída:

public class Column
{
  // popisek sloupce
  public string Text { get; set; }
  
  // hodnota sloupce
  public int Value { get; set; }
}

Program bude obsahovat 3 formuláře:

1. MainForm Obyčejné okno s hlavním menu (MainMenuStrip) a panelem nástrojů (ToolStrip).
2. ListForm Okno se seznamem se seznam sloupců a jejich hodnot. Bude obsahovat seznam (ListBox) a tlačítka (Button) pro přidání, smazání a odebrání položky ze seznamu.
3. DataForm Dialogové okno pro zadání informací o sloupci s validací hodnot.

DataForm

• Formulář s chováním běžného dialogového okna (okraje, tlačítka popisku).
• Obsahuje dvě tlačíka pro potvrzení dialogu (OK, Storno).
• Dvě textová pole pro zadání názvu sloupce (neprázdného) a celočíselné hodnoty (kladné celé číslo).
• Jestliže jsou zadány špatné hodnoty, pak dialog není možné potvrdit pomocí tlačítka OK, ale je možné jej zavřít tlačítkem Storno.
• Přidejte i dvě vlastnosti pro předávání nastavených hodnot volajícímu resp. pro nastavení hodnot před zobrazením. Alternativně můžete pro nastavení vytvořit i konstruktor se dvěma parametry.

Hints

• String.IsNullOrWhitespace, int.Parse, int.TryParse
• Pro validaci ovládacího prvku použijte jeho událost Validating. Její druhý parameter je typu CancelEventArgs, který má vlastnost Cancel. Nastavením Cancel na true označíte ovládací prvek za nevalidní.
• Vlastnost ovladacího prvku CauseValidation ovlivní, jestli ovládací prvek vyvolá validaci formuláře.
• Metoda ValidateChildren() formuláře vyvolá validaci všech ovladacích prvků na něm. Vrací true pokud jsou všechny validní.
• (+) Pro zobrazení chyb můžete použít komponentu ErrorProvider (ToolBox - kategorie Components), která má metodu SetError. První parametr metody je ovládácí prvek na kterém vznikla chyba a druhý je textový řetězec s chybovou hláškou. Po nastavení hlášky se vedle příslušného ovládacího prvku zobrazí varovný symbol s hláškou jako tooltipem. Zrušení hlášky provedete prázdným chybovým řetezcem.
• Tlačítka modálního dialogu vám jej potvrdí vždy, bez ohledu na validaci. Workaround:

  private void okButton_Click(object sender, EventArgs e)
  {
    if (ValidateChildren())
    {
      DialogResult = DialogResult.OK;
    }
    else
    {
      DialogResult = DialogResult.None;
      MessageBox.Show("Invalid data.");
    }
  }

ListForm

• Formulář obsahuje seznam sloupců (ListBox) a 4 tlačítka.
• Tlačítko 'Přidat' zobrazí modální dialogové okno pro zadání dat pro nový sloupec a přidá jej do seznamu.
• Tlačítko 'Smazat' smaže aktuálně vybranou položku v seznamu.
• Tlačítko 'Změnit' zobrazí modální dialogové okno s hodnotami aktuálně vybraného řádku v seznamu a po potvrzení změní hodnotu.

Hints

• ListBox.SelectedItems, ListBox.SelectedIndex, ListBox.Items.Add, ListBox.Items.Remove, ListBox.Items.IndexOf, ListBox.Items[i]
• ListBox ve výchozím nastavení zobrazuje pouze text, ale může obsahovat položky libovolného typu. Zobrazený text získá pomocí volání metody ToString na příslušné položce.
• Pokud změníte hodnotu položky seznamu zjistíte, že text příslušné položky se nezmění. Je to proto, že List Box si cachuje popisky. Změnu lze vynutit přiřazením položky do sebe.

  dataListBox.Items[index] = dataListBox.Items[index];

• Vytvořte si vlastnost nebo metody, které budou předávat pole Column[] do nebo z formuláře pro komunikaci s volající třídou. Alternativně můžete použít seznam.
• Seznam položek komponenty ListBox je typu ObjectCollection a její položky jsou typu object, takže opravdu může obsahovat cokoliv. Pro převedení na sloupce použijte přetypování.

MainForm

• Hlavní menu (MenuStrip) obsahuje položku "Aplikace", která jako podmenu obsahuje položky "Nastavit data grafu..." a "Konec". Mezi těmito položkami bude rozdělovník (Separator).
  • Nastavit data grafu...: zobrazí formulář ListForm a po jeho potvrzení překreslí graf s novými sloupci.
  • Konec: ukončí aplikaci.
  • Nastavete klávesové zkratky pro položky.
• Panel nástrojů bude obsahovat tlačítko s popiskou a obrázkem, které vykoná stejnou akci jako položka menu Nastavit data grafu....
• Zbytek prostoru na formuláři vyplňte panelem, do kterého budete vykreslovat sloupcový graf pro zadané sloupce.
  • Formulář obsahuje pole sloupců jako soukromou datovou položku. Toto pole je pak vykreslováno.
  • Graf je vykreslen přes většinu volné plochy, tedy šířka sloupců závisí na šířce panelu resp. formuláře
  • Nad nebo pod každým sloupcem je vypsán popisek sloupce a jeho hodnota.
  • Sloupce s největší hodnotou je zobrazen na celou výšku grafu, ostatní sloupce jsou zobrazeny v poměru k němu.
  • Pozadí grafu nechť tvoří barevný gradient.

Hints

• Pole sloupců nezapomeňte před prvním vykreslením inicializovat (z null na prázdné pole new Column[0]).
• Nezapomeňte volat Invalidate() pro vynucení překleslení grafu a ujistěte se, že ho voláte na správném ovládacím prvku.

(+)

• Do hlavního menu přidejte položku "Barva", jejíž submenu bude obsahovat položky menu měnící barvu na výplně grafu.
• Každý ovládací prvek, položky menu nevyjímaje, má vlastnost Tag typu object. Do této vlastnosti si můžete uložit naprosto cokoliv. Zamyslete se, jak by vám to mohlo ušetřit práci na předchozím úkolu.
• Do menu "Barva" přidejte položku, která otevře formulář pro nastavení vlastní barvy. Formulář vytvořte jako modální se 3 posuvníky (ToolBox, kategorie All Windows Forms - VScrollBar nebo HScrollBar) s rozsahem 0-255 (Minimum, Maximum) pro zadání barevných složek: červené, zelené a modré.