Xamarin.Forms Kurz entry

K dokončení tohoto kurzu byste měli mít Visual Studio 2019 (nejnovější vydanou verzi) s nainstalovanou sadou funkcí Vývoj mobilních aplikací pomocí .NET. Kromě toho budete potřebovat spárovaný Mac pro sestavení aplikace z kurzu v iOSu. Informace o instalaci platformy Xamarin najdete v článku Instalace Xamarinu. Informace o připojení sady Visual Studio 2019 k hostiteli buildu pro Mac najdete v článku Spárování s počítačem Mac pro vývoj na platformě Xamarin.iOS.

1. Spusťte Visual Studio a vytvořte novou prázdnou Xamarin.Forms aplikaci s názvem EntryTutorial.

   Důležité

   Fragmenty kódu C# a XAML v tomto kurzu vyžadují, aby řešení mělo název EntryTutorial. Použití jiného názvu způsobí při kopírování kódu z tohoto kurzu do řešení chyby sestavení.

   Další informace o knihovně .NET Standard, která se vytvoří, najdete v tématu Anatomie Xamarin.Forms aplikace v podrobném Xamarin.Forms kurzu Rychlý start.

2. V Průzkumníkovi řešení v projektu EntryTutorial poklikáním otevřete soubor MainPage.xaml. Pak v souboru MainPage.xaml odeberte veškerý kód šablony a nahraďte ho následujícím kódem:

   <?xml version="1.0" encoding="utf-8"?>
   <ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
                xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
                x:Class="EntryTutorial.MainPage">
       <StackLayout Margin="20,35,20,20">
           <Entry Placeholder="Enter text" />
       </StackLayout>
   </ContentPage>
   

   Tento kód deklarativně definuje uživatelské rozhraní pro stránku, která se skládá z objektu Entry v objektu StackLayout. Vlastnost Entry.Placeholder určuje zástupný text, který se ukáže při prvním zobrazení objektu Entry.

3. Na panelu nástrojů sady Visual Studio stiskněte tlačítko Spustit (trojúhelníkové tlačítko, která se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném vzdáleném simulátoru iOSu nebo emulátoru Androidu:

   

   V sadě Visual Studio zastavte aplikaci.

K dokončení tohoto kurzu byste měli mít Visual Studio pro Mac (nejnovější vydanou verzi) s nainstalovanou podporou pro platformy iOS a Android. Kromě toho budete také potřebovat Xcode (nejnovější vydanou verzi). Další informace o instalaci platformy Xamarin najdete v článku Instalace Xamarinu.

1. Spusťte Visual Studio pro Mac a vytvořte novou prázdnou Xamarin.Forms aplikaci s názvem EntryTutorial.

   Důležité

   Fragmenty kódu C# a XAML v tomto kurzu vyžadují, aby řešení mělo název EntryTutorial. Použití jiného názvu způsobí při kopírování kódu z tohoto kurzu do řešení chyby sestavení.

   Další informace o knihovně .NET Standard, která se vytvoří, najdete v tématu Anatomie Xamarin.Forms aplikace v podrobném Xamarin.Forms kurzu Rychlý start.

2. V Oblasti řešení v projektu EntryTutorial poklikáním otevřete MainPage.xaml. Pak v souboru MainPage.xaml odeberte veškerý kód šablony a nahraďte ho následujícím kódem:

   <?xml version="1.0" encoding="utf-8"?>
   <ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
                xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
                x:Class="EntryTutorial.MainPage">
       <StackLayout Margin="20,35,20,20">
           <Entry Placeholder="Enter text" />
       </StackLayout>
   </ContentPage>
   

   Tento kód deklarativně definuje uživatelské rozhraní pro stránku, která se skládá z objektu Entry v objektu StackLayout. Vlastnost Entry.Placeholder určuje zástupný text, který se ukáže při prvním zobrazení objektu Entry.

3. Na panelu nástrojů sady Visual Studio pro Mac stiskněte tlačítko Spustit (trojúhelníkové tlačítko, které se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném simulátoru iOSu nebo emulátoru Androidu:

   

   V sadě Visual Studio pro Mac zastavte aplikaci.

1. V souboru MainPage.xaml můžete upravit deklaraci objektu Entry tak, aby nastavila obslužnou rutinu pro události TextChanged a Completed:

   <Entry Placeholder="Enter text"
          TextChanged="OnEntryTextChanged"
          Completed="OnEntryCompleted" />
   

   Tento kód nastaví událost TextChanged na obslužnou rutinu události s názvem OnEntryTextChanged a událost Completed na obslužnou rutinu události s názvem OnEntryCompleted. Obě obslužné rutiny událostí vytvoříme v následujícím kroku.

2. V Průzkumníkovi řešení v projektu EntryTutorial rozbalte uzel MainPage.xaml a poklikáním otevřete soubor MainPage.xaml.cs. Potom v souboru MainPage.xaml.cs přidejte do třídy obslužné rutiny událostí OnEntryTextChanged a OnEntryCompleted:

   void OnEntryTextChanged(object sender, TextChangedEventArgs e)
   {
       string oldText = e.OldTextValue;
       string newText = e.NewTextValue;
   }
   
   void OnEntryCompleted(object sender, EventArgs e)
   {
       string text = ((Entry)sender).Text;
   }
   

   Když se text v objektu Entry změní, spustí se metoda OnEntryTextChanged. Argument sender je objekt Entry odpovídající za vyvolání události TextChanged a dá se použít pro přístup k objektu Entry. Argument TextChangedEventArgs poskytuje starou a novou textovou hodnotu (před změnou textu a po ní).

   Při dokončení zadávání textu do objektu Entry stisknutím klávesy Return se spustí metoda OnEntryCompleted. Argument sender je objekt Entry odpovídající za vyvolání události TextChanged a dá se použít pro přístup k objektu Entry.

   Důležité

   Jakýkoliv text zadaný do objektu Entry se uloží ve vlastnosti Text.

3. Na panelu nástrojů sady Visual Studio stiskněte tlačítko Spustit (trojúhelníkové tlačítko, která se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném vzdáleném simulátoru iOSu nebo emulátoru Androidu:

   

   Nastavte zarážky v těchto dvou obslužných rutinách událostí, zadejte text do objektu Entry a sledujte vyvolání událostí TextChanged a Completed.

   Další informace o událostech naleznete v tématu Události a interaktivita v průvodci Xamarin.Forms položkami.Entry

1. V souboru MainPage.xaml můžete upravit deklaraci objektu Entry tak, aby nastavila obslužnou rutinu pro události TextChanged a Completed:

   <Entry Placeholder="Enter text"
          TextChanged="OnEntryTextChanged"
          Completed="OnEntryCompleted" />
   

   Tento kód nastaví událost TextChanged na obslužnou rutinu události s názvem OnEntryTextChanged a událost Completed na obslužnou rutinu události s názvem OnEntryCompleted. Obě obslužné rutiny událostí vytvoříme v následujícím kroku.

2. V Oblasti řešení v projektu EntryTutorial rozbalte uzel MainPage.xaml a poklikáním otevřete soubor MainPage.xaml.cs. Potom v souboru MainPage.xaml.cs přidejte do třídy obslužné rutiny událostí OnEntryTextChanged a OnEntryCompleted:

   void OnEntryTextChanged(object sender, TextChangedEventArgs e)
   {
       string oldText = e.OldTextValue;
       string newText = e.NewTextValue;
   }
   
   void OnEntryCompleted(object sender, EventArgs e)
   {
       string text = ((Entry)sender).Text;
   }
   

   Když se text v objektu Entry změní, spustí se metoda OnEntryTextChanged. Argument sender je objekt Entry odpovídající za vyvolání události TextChanged a dá se použít pro přístup k objektu Entry. Argument TextChangedEventArgs poskytuje starou a novou textovou hodnotu (před změnou textu a po ní).

   Při dokončení zadávání textu do objektu Entry stisknutím klávesy Return se spustí metoda OnEntryCompleted. Argument sender je objekt Entry odpovídající za vyvolání události TextChanged a dá se použít pro přístup k objektu Entry.

   Důležité

   Jakýkoliv text zadaný do objektu Entry se uloží ve vlastnosti Text.

3. Na panelu nástrojů sady Visual Studio pro Mac stiskněte tlačítko Spustit (trojúhelníkové tlačítko, které se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném simulátoru iOSu nebo emulátoru Androidu:

   

   Nastavte zarážky v těchto dvou obslužných rutinách událostí, zadejte text do objektu Entry a sledujte vyvolání událostí TextChanged a Completed.

   Další informace o Entry událostech naleznete v tématu Události a interaktivita v průvodci Xamarin.Forms položkami .

1. V souboru MainPage.xaml můžete úpravou deklarace objektu Entry přizpůsobit jeho chování:

   <Entry Placeholder="Enter password"
          MaxLength="15"
          IsSpellCheckEnabled="false"
          IsTextPredictionEnabled="false"
          IsPassword="true" />
   

   Tento kód nastavuje vlastnosti, které přizpůsobují chování objektu Entry. Vlastnost MaxLength omezuje délku vstupu povolenou pro objekt Entry a vlastnost IsSpellCheckEnabled je nastavená na false a zakazuje kontrolu pravopisu. Podobně je vlastnost IsTextPredictionEnabled nastavená na false, aby se zakázalo prediktivní vkládání textu a automatické prediktivní vkládání textu. Kromě toho vlastnost IsPassword zajišťuje, že se zadávané znaky maskují pomocí znaku hesla (černé kolečko).

   Poznámka:

   V některých scénářích zadávání textu, jako je například zadávání hesla, není kontrola pravopisu a prediktivní vkládání textu žádoucí a proto by měly být vypnuty.

2. Pokud aplikace stále běží, uložte změny do souboru a uživatelské rozhraní aplikace se v simulátoru nebo emulátoru aktualizuje automaticky. V ostatních případech na panelu nástrojů sady Visual Studio stiskněte tlačítko Spustit (trojúhelníkové tlačítko, které se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném vzdáleném simulátoru iOSu nebo emulátoru Androidu. Zadejte text do objektu Entry a sledujte, jak se každý znak nahradí znakem masky hesla. Všimněte si také, že maximální počet znaků, které můžete zadat, je 15:

   

   V sadě Visual Studio zastavte aplikaci.

   Další informace o přizpůsobení Entry chování naleznete v průvodci Xamarin.Forms položkami .

1. V souboru MainPage.xaml můžete úpravou deklarace objektu Entry přizpůsobit jeho chování:

   <Entry Placeholder="Enter password"
          MaxLength="15"
          IsSpellCheckEnabled="false"
          IsTextPredictionEnabled="false"
          IsPassword="true" />
   

   Tento kód nastavuje vlastnosti, které přizpůsobují chování objektu Entry. Vlastnost MaxLength omezuje délku vstupu povolenou pro objekt Entry a vlastnost IsSpellCheckEnabled je nastavená na false a zakazuje kontrolu pravopisu. Podobně je vlastnost IsTextPredictionEnabled nastavená na false, aby se zakázalo prediktivní vkládání textu a automatické prediktivní vkládání textu. Kromě toho vlastnost IsPassword zajišťuje, že se zadávané znaky maskují pomocí znaku hesla (černé kolečko).

   Poznámka:

   V některých scénářích zadávání textu, jako je například zadávání hesla, není kontrola pravopisu a prediktivní vkládání textu žádoucí a proto by měly být vypnuty.

2. Pokud aplikace stále běží, uložte změny do souboru a uživatelské rozhraní aplikace se v simulátoru nebo emulátoru aktualizuje automaticky. V ostatních případech na panelu nástrojů sady Visual Studio pro Mac stiskněte tlačítko Spustit (trojúhelníkové tlačítko, které se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném simulátoru iOSu nebo emulátoru Androidu. Zadejte text do objektu Entry a sledujte, jak se každý znak nahradí znakem masky hesla. Všimněte si také, že maximální počet znaků, které můžete zadat, je 15:

   

   V sadě Visual Studio pro Mac zastavte aplikaci.

   Další informace o přizpůsobení Entry chování naleznete v průvodci Xamarin.Forms položkami .