Como utilizar o Address Chooser Task no Windows Phone

Com certeza, em um dos seus projetos, voc� ter� a necessidade de obter o endereço de um contato do seu usu�rio no Windows Phone, e esse Task � utilizado justamente para isso. O Address Chooser Task inicia o aplicativo de Contatos, permitindo assim ao usu�rio escolher um contato de sua lista. Assim que o usu�rio concluir a tarefa, � gerado um evento e o manipulador de eventos recebe um endereço no resultado.

No exemplo deste artigo ser� criada uma aplicaç�o em que o usu�rio ir� selecionar o contato e os dados deste contato ser�o exibidos em seguida na mesma p�gina em um formul�rio.

Abra o Visual Studio e crie um projeto Windows Phone Application chamado ProjetoAddressChooser conforme a Figura 1.

Figura 1. Criaç�o do Projeto ProjetoAddressChooser no Visual Studio

Ao criar o projeto, � exibida uma caixa com a opç�o de escolha da vers�o do Windows Phone, escolha a 7.1, pois assim o seu aplicativo funcionar� em todas as vers�es de Windows Phone dispon�veis.

Abra o arquivo MainPage.xaml e v� ao content panel para adicionar um stackpanel que conter� o Bot�o que ir� exibir ao usu�rio a seleç�o de contato e um formul�rio que iniciar� no Visibility Collapsed, a MainPage.xaml dever� ficar conforme mostra a Listagem 1.

<phone:PhoneApplicationPage 
    x:Class="ProjetoAddressChooser.MainPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
    xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d" d:DesignWidth="480" d:DesignHeight="768"
    FontFamily="{StaticResource PhoneFontFamilyNormal}"
    FontSize="{StaticResource PhoneFontSizeNormal}"
    Foreground="{StaticResource PhoneForegroundBrush}"
    SupportedOrientations="Portrait" Orientation="Portrait"
    shell:SystemTray.IsVisible="True">

    <!--LayoutRoot is the root grid where all page content is placed-->
    <Grid x:Name="LayoutRoot" Background="Transparent">
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>

        <!--TitlePanel contains the name of the application and page title-->
        <StackPanel x:Name="TitlePanel" Grid.Row="0" Margin="12,17,0,28">
            <TextBlock x:Name="ApplicationTitle" Text="MY APPLICATION" 
            />
            <TextBlock x:Name="PageTitle" Text="contatos" Margin="9,-7,0,0" 
            />
        </StackPanel>

        <!--ContentPanel - place additional content here-->
        <Grid x:Name="ContentPanel" Grid.Row="1" Margin="12,0,12,0">
            <StackPanel Width="450" Height="500" VerticalAlignment="Top">
                <StackPanel Width="450" Height="80" VerticalAlignment="Top">
                    <Button Name="btnExibirContatos" Width="400" Height="80" 
                    Content="Exibir Contatos"  Click="btnExibirContatos_Click_1"/>
                </StackPanel>
                <Border Name="brdFormulario" BorderBrush="White" 
                BorderThickness="2" Width="450" Height="400" 
                Visibility="Collapsed">
                    <StackPanel Width="450" Height="400">
                        <TextBlock Foreground="White" Text="Formul�rio" 
                         FontWeight="Bold" FontSize="25" Margin="10"/>
                        <TextBlock Name="lblNome" Foreground="White" 
                         Text="Nome : " FontSize="25" Margin="10"/>
                        <TextBlock Name="lblEndereco" Foreground="White" 
                         Text="Endereço : " FontSize="25" Margin="10"/>
                    </StackPanel>
                </Border>
            </StackPanel>
        </Grid>
    </Grid>
 
</phone:PhoneApplicationPage>

Listagem 1. Criaç�o do StackPanel que conter� o bot�o de seleç�o de contato e o formul�rio

Ent�o, agora abra o arquivo MainPage.xaml.cs e adicione uma refer�ncia no topo da classe para o Microsoft.Phone.Tasks como mostra a Listagem 2.

using Microsoft.Phone.Tasks;

Listagem 2. Adicionando refer�ncia

Agora voc� dever� tratar e utilizar a classe no evento btnExibirContatos_Click_1 para exibir a lista de contatos, como mostra a listagem 3. No caso, � feita uma inst�ncia da classe AddressChooserTask e ent�o a criaç�o do m�todo call-back ap�s o t�rmino da escolha do contato e tamb�m o m�todo Show para exibir a lista de contatos ao usu�rio; Voc� dever� tamb�m implementar o m�todo addressChooser_Completed, para manipular e receber as informaç�es do contato que o usu�rio escolheu, veja na Listagem 3.

Observaç�o: O m�todo de call-back � colocado antes do m�todo Show do AddressChooserTask porque � uma chamada ass�ncrona, ou seja, ele j� deve saber o que ir� fazer ao completar a aç�o antes de inici�-la.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Animation;
using System.Windows.Shapes;
using Microsoft.Phone.Controls;
using Microsoft.Phone.Tasks;

namespace ProjetoAddressChooser
{
    public partial class MainPage : PhoneApplicationPage
    {        
        // Constructor
        public MainPage()
        {
            InitializeComponent();
        }

        private void btnExibirContatos_Click_1(object sender, RoutedEventArgs e)
        {
            AddressChooserTask addressChooser = new AddressChooserTask();
            addressChooser.Completed += addressChooser_Completed;
            addressChooser.Show();
        }

        void addressChooser_Completed(object sender, AddressResult e)
        {
            if (e.TaskResult == TaskResult.OK)
            {
                string endereco = e.Address;
                string nome = e.DisplayName;
                exibirFormulario(nome,endereco);
            }
            else
            {
                MessageBox.Show("Erro ao buscar contato.");
            }
        }

        private void exibirFormulario(string nome, string endereco)
        {
            lblNome.Text = nome;
            lblEndereco.Text = endereco;
            brdFormulario.Visibility = System.Windows.Visibility.Visible;
        }
    }
}

Listagem 3. Implementaç�o dos m�todos na classe MainPage.xaml.cs

Por ser uma plataforma bastante segura, o Windows Phone restringe e limita certos acessos ao desenvolvedor, como por exemplo, a navegaç�o das p�ginas com a passagem dos dados do contato como par�metro. Apesar da limitaç�o, isso garante para os usu�rios uma maior confiança nas aplicaç�es desenvolvidas para o Windows Phone e aprovadas no Windows Phone Store.

Para efetuar o teste desta aplicaç�o no emulador, � necess�rio que voc� adicione uma conta de e-mail para conter os contatos dispon�veis para seleç�o, conforme o exemplo. Ent�o abra o emulador e v� em configuraç�o, conforme a Figura 2.

Figura 2. Como acessar a configuraç�o no emulador do Windows Phone

E ent�o agora selecione email+accounts nas opç�es de configuraç�o e clique em add na account, como mostra a Figura 3.

Figura 3. Adicionando nova conta nas configuraç�es

Ent�o, agora selecione uma conta de e-mail para vincular e insira os dados seguindo os passos indicados no dispositivo.

Ap�s a configuraç�o de pelo menos uma conta de e-mail, voc� poder� pressionar F5 e testar sua aplicaç�o, como mostra a Figura 4.

Figura 4. Testando a aplicaç�o

Como utilizar o Address Chooser Task no Windows Phone

Veja neste artigo como utilizar o Address Chooser Task para obter o endereço de um contato selecionado pelo usuário.

Artigos relacionados