Etichette in Xamarin.iOS

Il UILabel controllo viene utilizzato per visualizzare testo singolo e multilinea, di sola lettura.

Implementazione di un'etichetta

Viene creata una nuova etichetta creando un'istanza UILabeldi :

UILabel label = new UILabel();

Etichette e storyboard

È anche possibile aggiungere un'etichetta all'interfaccia utente quando si usa progettazione iOS. Cercare Etichetta nella casella degli strumenti e trascinarla nella visualizzazione:

È possibile regolare le proprietà seguenti nel riquadro delle proprietà:

• Contesto di testo: normale o con attributi. Il testo normale consente di impostare gli attributi di formattazione sull'intera stringa. I testi con attributi consentono di impostare la formattazione su caratteri o parole diversi nella stringa.
• Colore, Tipo di carattere, Allineamento : attributi di formattazione che possono essere applicati all'etichetta.
• Righe : imposta il numero di righe che l'etichetta può estendersi. Impostare questo valore su 0 per consentire all'etichetta di usare il numero di righe necessario.
• Comportamento : può essere impostato su Abilitato o Evidenziato. Abilitato è impostato per impostazione predefinita, il testo disabilitato verrà visualizzato in un colore grigio più chiaro. L'opzione Evidenziata è disabilitata per impostazione predefinita e consente di ridisegnare l'etichetta con uno stato evidenziato quando viene selezionata da un utente.
• Basilea e break di linea –
  • Basline determina la modalità di posizionamento del testo se le dimensioni del carattere sono diverse da quella specificata.
  • Interruzioni di riga determinano la modalità di wrapping o troncamento di una stringa se è più lunga di una singola riga.
• Autoshrink : determina la modalità di riduzione al minimo delle dimensioni del carattere all'interno di un'etichetta, se necessario.
• Evidenziato, Ombreggiatura, Offset : consente di impostare il colore Hightlighted e Shadow e l'offset dell'ombreggiatura.

Troncamento e wrapping

Per informazioni sull'uso delle interruzioni di riga in iOS, vedere la ricetta Truncate and Wrap text .For information on using the line break in iOS, refer to the Truncate and Wrap text recipe.

Formattazione di testo ed etichetta

Per formattare la stringa usata in un'etichetta, è possibile impostare gli attributi di formattazione sull'intera stringa oppure usare stringhe con attributi. Gli esempi seguenti illustrano come implementare questi elementi:

label = new UILabel(){
                Text = "Hello, this is a string",
                Font = UIFont.FromName("Papyrus", 20f),
                TextColor = UIColor.Magenta,
                TextAlignment = UITextAlignment.Center
            };

label.AttributedText = new NSAttributedString(
                "This is some formatted text",
                font: UIFont.FromName("GillSans", 16.0f),
                foregroundColor: UIColor.Blue,
                backgroundColor: UIColor.White
            );

Per altre informazioni sullo stile del testo con NSAttributedString fare riferimento alla ricetta Stile testo .

Per impostazione predefinita, le etichette hanno impostato Enabled su true, ma è possibile impostarla su disabilitata per dare all'utente un suggerimento che un determinato controllo sia disabilitato:

label.Enabled = false;

In questo modo l'etichetta viene impostata su un colore grigio chiaro, come illustrato nell'immagine di esempio seguente della schermata Restrizioni in iOS:

È anche possibile impostare i colori Evidenzia e Ombreggiatura del testo sul testo dell'etichetta per altri effetti:

label.Highlighted = true;
label.HighlightedTextColor = UIColor.Cyan;

label.ShadowColor = UIColor.Black;
label.ShadowOffset = new CoreGraphics.CGSize(1.0f, 1.0f);

In questo modo viene visualizzato il testo seguente:

Per altre informazioni sulla modifica del tipo di carattere di un'etichetta UILabel, vedere la ricetta Modifica tipo di carattere .