Task Pane Manager

   Você pode abrir o Task Pane Manager a partir do menu Tools do Visual FoxPro ou clicando no ícone Task Pane localizado na barra de ferramentas padrão do Visual FoxPro. O Task Pane Manager é basicamente um recipiente que exibe o conteúdo dentro de um painel. Esse é um formulário redimensionável com duas seções—a barra de ferramentas e a área do painel (Figura 1). A barra de ferramenta sempre é exibida e contém botões do link do painel personalizável pelo usuário que carregam os painéis especificados na área do painel. Também há botões para Task Pane Manager Options, um botão refresh, que carrega novamente o painel atual e um menu que exibe o restante dos links do painel que não apareceu na barra de ferramentas. É na área do painel que o conteúdo específico do painel é exibido.

  
   Figura 1 O Task Pane Manager do Visual FoxPro com o painel Start exibido

Muitos painéis padrão acompanham o Visual FoxPro 8.0. Eles ajudam você a concluir rapidamente as tarefas fornecendo acesso às ferramentas RAD, assistentes e códigos de exemplo. Alguns puxam conteúdo dinâmico da Internet diretamente para sua área de trabalho de modo que a Microsoft possa mantê-lo atualizado com informações relacionadas ao produto, notícias da comunidade, documentos e informações do XML Web service. Pode-se fazer o download desse tipo de conteúdo para painéis baseados em suas configurações de cache.

Cada painel de tarefas armazena qualquer conteúdo ou código criado ou necessário em seu cache do painel. O cache do painel para um painel específico está localizado em uma pasta baseada no ID em sua pasta HOME(7), ou seja, \Documents and Settings\UserName\Application Data\Microsoft\Visual FoxPro 8\TaskPane\PaneCache\PaneUniqueID. Para painéis dinâmicos, esse é o local onde se faz download e armazena conteúdo da Internet. Por padrão, sempre que é aberto, o Task Pane Manager verifica o novo conteúdo da Internet. Você define essa opção a partir de Task Pane Manager Options que pode ser acessado a partir do botão Options na barra de ferramentas. Selecione Task Pane Manager na exibição de árvore para verificar as configurações globais para o Task Pane Manager (Figura 2). Nesta seção, você também pode especificar qual painel deve ser exibido quando você abrir o Task Pane Manager bem como se ele deve ser aberto automaticamente ao iniciar o Visual FoxPro. Por padrão, cada painel que faz o download de conteúdo da Internet presta atenção à configuração global Check for new Internet content aqui especificada.

  
   Figura 2 O Task Pane Manager Options exibe opções globais bem como opções específicas para cada painel.

Você pode controlar a freqüência de download de conteúdo da Internet para seu cache do painel selecionando as seguintes opções:

Every time you start the Task Pane Manager

Selecione esta opção se você estiver online, mas possuir uma conexão lenta. É feito o download do novo conteúdo apenas uma vez a cada sessão.

Every time the pane is loaded

Selecione esta opção se você estiver online com uma conexão de Internet constante e de alta velocidade. Sempre que o painel é carregado, é feito o download do conteúdo, e o cache é sempre atualizado.

Every x days

Selecione esta opção se você tiver acesso à Internet, mas possuir uma conexão lenta. Apenas o novo conteúdo é puxado para um painel se o prazo de X ou mais dias estiver esgotado.

Never

Selecione esta opção se você estiver off-line e não possuir acesso à Internet. O conteúdo do painel é sempre obtido a partir do cache.

Você pode modificar essa configuração para painéis individuais selecionando o nome do painel a partir da exibição de árvore e especificando a opção apropriada. Alguns painéis de tarefa que a Microsoft distribui possuem opções adicionais específicas do painel. Caso haja opções a serem configuradas, elas aparecerão à direita quando o painel for selecionado a partir da exibição de árvore. Por exemplo, os painéis que possuírem várias seções podem ser configurados para exibir somente as seções que você desejar. Os nomes das seções aparecem como caixas de seleção que, por padrão, estão todas marcadas.

Painel de Tarefas Start

O painel Start é exibido na primeira vez em que o Task Pane Manager é aberto. Este painel apresenta quarto seções: Start, My Tools, Recent Projects e Recent Databases. Ele também apresenta um link no final que abre Task Pane Manager Options. A seção Start exibe conteúdo a partir de um arquivo XML na Internet. Ele pode conter links para tópicos de Ajuda, documentos, assistentes e a outros sites da Web. Quando a Microsoft atualiza o conteúdo, é feito o download dele para esta seção do painel Start periodicamente dependendo de suas configurações de cache. A seção My Tools fornece acesso rápido a ferramentas, utilitários e script que você geralmente executa quando está no IDE. Clique em Manage para abrir o aplicativo My Tools e definir suas ferramentas. Quando você fecha o formulário, o painel é atualizado, e a lista de suas ferramentas aparece em uma lista suspensa. Selecione uma ferramenta a partir da lista e clique em Run para executar a ferramenta.

As seções Recent Projects e Recent Databases exibem os projetos e bancos de dados abertos mais recentemente. Isso é referido como uma lista MRU (most recently used). Essas seções lêem e exibem essa informação a partir de seu arquivo de recurso do FoxPro (FOXUSER). Essas seções listam o nome do projeto/banco de dados, caminho e data abertos recentemente. Clique no nome do projeto ou do banco de dados para abri-lo. Clique em Open Project ou em Open Database para abrir um projeto ou banco de dados que não está na lista. Clique em New Project ou New Database para criar um novo projeto ou banco de dados.

O painel Start é um painel HTML e pode possuir qualquer elemento de HTML ou Dynamic HTML apresentado na área do painel. Isso será explicado posteriormente neste documento, mas por enquanto saiba que os painéis que usam linguagens mark-up são hospedados no controle ActiveX do Navegador Web do Internet Explorer. Desse modo, quando um hiperlink for ativado, o Visual FoxPro pode interceptar o evento e executar o código. É dessa forma que os aplicativos, arquivos de Ajuda e as caixas de diálogo são chamados ao clicar em um hiperlink. Por exemplo, Manage executa o aplicativo My Tools. Para obter mais informações, consulte "Using Built-In Handlers" neste documento.

Painel de Tarefas Community

O painel Community exibe o conteúdo útil da comunidade a partir de provedores confiáveis na Internet. Ele lista links da comunidade, downloads, artigos, treinamento, tópicos e notícias a partir de FoxCentral, Universal Thread e FoxPro Wiki no subtítulo News. Por padrão, apenas FoxCentral aparece. Você pode selecionar os demais provedores e fornecer o nome de usuário e senha para Universal Thread em Task Pane Options. (É necessário o registro para o Universal Thread antes de acessar o conteúdo que ele fornece; no entanto, a participação básica é gratuita.) Os itens podem ser classificados em ordem crescente e decrescente por data, título ou provedor selecionando as listas suspensas apropriadas acima dos itens de notícia. Expanda um item de notícia para visualizar sua descrição clicando no sinal de mais (+) ao lado do item. Para abrir o item, clique no título, que é um hiperlink que abre o URL do item em uma janela do navegador.

O painel Community é um painel XML que chama XML Web services para recuperar o conteúdo no formato de dados XML. Se você clicar com o botão direito do mouse na área do painel e selecionar View Source a partir do menu de atalho, XML é exibido (Figura 3). Os dados XML que retornam de cada um dos provedores são, então, transformados em um formato padrão e exibidos no painel com um arquivo XLS estático localizado no cache do painel chamado News.xsl. XSLT oferece a classificação nos dados XML.

  
   Figura 3 O painel Community exibe dados XML recuperados de XML Web services.

Painel de Tarefas Environment Manager

O painel Environment Manager exibe conjuntos de ambiente e projetos associados que você define usando uma ferramenta chamada Environment Manager. É onde você pode organizar configurações de ambiente em grupos e projetos associados a eles. Quando você abre um projeto a partir deste painel, ele executa as configurações de ambiente antes de o projeto abrir. O aplicativo Environment Manager está localizado no diretório base do Visual FoxPro e é chamado EnvMgr.app. Ele armazena os conjuntos de ambiente que você criou em uma tabela localizada em sua pasta HOME(7) e é chamado EnvMgr.dbf. Como o painel Community, o Environment Manager também é um painel XML. No entanto, em vez de obter dados XML a partir de Web services na Internet, ele seleciona dados a partir da tabela EnvMgr.dbf em um cursor e retorna XML usando a função CURSORTOXML. Ele então exibe os dados XML usando o arquivo XSL estático localizado no cache do painel chamado Envmgr.xsl.

Painel de Tarefas Solution Samples

O painel Solution Samples apresenta uma lista que pode ser pesquisada de todas as soluções e os exemplos do Visual FoxPro contidos na pasta Samples\ no diretório base do Visual FoxPro. Ele exibe informações sobre os exemplos armazenados em duas tabelas de dados: um está localizado na pasta Samples\Solution e é chamado Solution.dbf, e o outro está localizado no cache do painel chamado Solutionaddins.dbf. O Solution.dbf contém informações sobre os exemplos que a Microsoft apresenta com o Visual FoxPro. O Solutionaddins.dbf é onde são mantidos os suplementos de exemplo que você instalou. Você pode ter exemplos de código que outros usuários fornecem incluídos aqui se for distribuído com o código de exemplo um suplemento de solução. Clique no botão Install Sample no final do painel de tarefas para localizar o arquivo de suplemento manifesto. O arquivo de manifesto é um arquivo XML que contém informações sobre o exemplo e a categoria a que ele pertence.

   < solutions vendor="VendorName" name="SolutionSetName">
< category key="CategoryKey">
< text>CategoryName< /text>
< image>PaneCacheImageFileName< /image>
< solution key="SampleKey" parent="CategoryKey">
< text>SampleName< /text>
< type>SampleType< /type>
< file>FileNameWithoutPath< /file>
< description>< ![CDATA[DescriptionText]]>< /description>
< /solution>
< /category>
< /solutions>

   Use esse formato para adicionar uma solução a uma categoria nova ou existente definindo o valor do atributo pai do elemento da solução para referir-se ao atributo da chave no elemento da categoria. O elemento descritivo do nó de solução pode ser uma seção CDATA de modo que HTML possa ser exibido na seção de descrição do exemplo. O elemento de imagem refere-se a um nome de imagem contido no cache do painel Microsoft.Solutions. Se você não especificar uma imagem, será exibida uma imagem padrão. Os elementos de arquivo e tipo de exemplo são usados para determinar como executar ou exibir o exemplo quando ele for executado ou quando o código for visualizado. Os valores para o elemento do tipo estão listados na seguinte tabela.

Valor	Significado
F	Formulário
R	Relatório
Q	Consulta
V	Exibição
A	Aplicativo
C	Programa (PRG)
P	Projeto
M	Arquivo está aberto usando o comando MODIFY FILE
D	Abrir Banco de Dados
S	Abrir o arquivo com o ShellExecute

   Por exemplo, você faz o download de um exemplo que inclui um manifesto e coloca-o na pasta \Samples\Solutions\MySamples\. O arquivo de manifesto é o seguinte:

   < ?xml version='1.0' encoding='windows-1252' standalone='no'?>
< solutions vendor="Massi" name="MySamples">
< category key="Massi_Samples">
< text>Beth's Cool Samples< /text>
< image>frm< /image>
< solution key="mysample" parent="Massi_Samples">
< text>My Cool Sample< /text>
< type>F< /type>
< file>mysample< /file>
< method>< /method>
< description>< ![CDATA[See how easy it is to create a manifest and install sample add-ins! Now < a href="vfps:linkto?url=http://www.bethmassi.com"> check out my website< /a> for more samples!]]>
< /description>
< /solution>
< /category>
< /solutions>

   No painel Solution Samples, clique em Install Sample e vá ao arquivo de manifesto. O exemplo é adicionado à lista de categorias de exemplo que podem ser pesquisados (Figura 4).

    
   Figura 4 Use exemplo de arquivos de manifesto do suplemento para instalar exemplos de terceiros diretamente no painel de tarefas.

Suplementos de exemplo podem ser removidos expandindo o exemplo na árvore e clicando no link Remove Imagem à direita.

A última seção do painel Solution Samples é uma seção dinâmica que puxa dados de um arquivo na Internet. Quando a Microsoft atualiza esse arquivo com links para sites que fornecem suplementos de exemplo, os links são exibidos nessa seção.

O painel Solution Samples é um dos painéis mais interessantes incluídos no Task Pane Manager. É um painel HTML controlado por um programa localizado no cache do painel chamado Solutions.prg. Esse programa também executa pesquisas e atualiza o painel usando Dynamic HTML por meio dos resultados XML armazenados em uma ilha de dados do Internet Explorer. O XML na ilha de dados é definido como a fonte de dados de uma tabela de resultados que é exibida na caixa de texto de pesquisa. Isso demonstra como você pode usar o código do Visual FoxPro para interagir facilmente com painéis de tarefas HTML, tirando vantagem do DOM (Document Object Model) do Internet Explorer. Você verá posteriormente um exemplo sobre como interagir com o Internet Explorer a partir do código do Visual FoxPro. Para obter mais informações sobre data islands, Dynamic HTML e DOM no Internet Explorer, consulte o Desenvolvimento na Web e MSXML 4.0 SDK na Biblioteca MSDN.

Painel de Tarefas XML Web Services

Pelo fato de a Microsoft ter ativado a Web programável, os XML Web services recebem um perfil muito maior nessa versão do Visual FoxPro. A partir do painel de tarefas XML Web Services, há mais ferramentas disponíveis para ajudá-lo a gerenciar, publicar e registrar XML Web services. Aqui você pode acessar ferramentas do XML Web services e explorar métodos de serviço. Selecione um XML Web service a partir da lista suspensa para testar os métodos e visualizar o código proxy. Também há uma seção dinâmica no final deste painel que puxa os dados de um arquivo na Internet que contém as informações mais recentes da Microsoft a respeito dos XML Web services.

O painel XML Web Services é um painel HTML que exibe informações sobre seus XML Web services registrados armazenados na tabela Foxws3.dbf localizada no diretório base do Visual FoxPro. O dado é selecionado a partir dessa tabela no formato de XML e é transformado em uma lista de serviços disponíveis. Quando você seleciona um serviço a partir da lista, o código executado usa as ferramentas do XML Web service.

Painel de Tarefas Filer

Filer é uma ferramenta com data anterior aos dias do Visual FoxPro. Ela ajuda a localizar e editar arquivos em seu computador. Sua funcionalidade está exposta em uma biblioteca COM chamada Filer.dll que contém a lógica do aplicativo, mas nenhuma interface de usuário. Você pode usar a biblioteca em seus aplicativos ao criar uma interface de usuário. O painel de tarefas Filer faz isso fornecendo uma interface de usuário que é acessada por meio do Task Pane Manager.

O painel de tarefas Filer (Figura 5) é um exemplo do uso de controles rich do Visual FoxPro em um painel de tarefas. Os controles são hospedados em uma classe que herda da classe PaneContainer do task Pane Manager e são armazenados em uma biblioteca de classe chamada Filer.vcx localizada no cache do painel. A classe PaneContainer define o recipiente para trabalhar com o Task Pane Manager. Quando você cria painéis de tarefas que usam controles rich do Visual FoxPro, você herda dessa classe. 

    
   Figura 5 O painel Filer herda da classe PaneContainer e contém controles rich do Visual FoxPro.

Painel de Tarefas Minesweeper

O painel Minesweeper é uma versão do Visual FoxPro do jogo minesweeper do Windows. Este painel também exibe controles rich do Visual FoxPro. No entanto, ao invés de a definição do painel ser armazenada em um arquivo de biblioteca de classe (.vcx), ela é definida em um arquivo de programa chamado Mines.prg localizado no cache do painel. Esse programa também apresenta um ótimo exemplo de como usar a classe Collection no Visual FoxPro.

   Voltar para o menu