=========
`xMova Android <../doc.html>`_
=========

-----------
Photo Gallery
-----------
``Versão 2.7+``

Esta funcionalidade permite ao usuário que sejam tiradas fotos independente de estar preenchendo um apontamento, é criado um opção no menu do topo que aparece mesmo com o turno fechado. As fotos salvas por esta opção são exibidas em uma galeria quando o usuário precisa preencher um campo de foto e seleciona a opção para escolher uma foto da galeria ao invés de tirar a foto.
O aplicativo gera a entidade ***_PHOTO_GALLERY*** automaticamente, caso não tenha sido sobrescrita no fluxo. A entidade gerada automaticamente pelo compiler possui os seguintes campos: id inc, picture Path, date Now e location caso a entidade Location exista no fluxo.
É possível sobrescrever a entidade **_PHOTO_GALLERY**, mas para isso é obrigatório que a entidade possua um campo do tipo Bytes ou Path para que o fluxo possa ser compilado.
Sempre que o usuário escolhe uma foto da galeria para atribuir a um campo do tipo picture o Core faz a transferência dos valores dos campos de mesmo nome e mesmo tipo presentes na entidade **_PHOTO_GALLERY** e na entidade cujo campo receberá o valor da foto.


Exemplo da configuração da galeria:


**Exemplo**::

  App appCode=X
	id 30099
	name xMova WebView
	version 1.0.398
	intVersion 389
	
	photoGallery
		cleanUpDays 9
		disableDelete



---------
Atributos:
---------

* ``cleanUpDays`` : Determina por quanto tempo o registro das fotos deve ser mantido, o valor padrão é 10 dias. Caso a entidade seja sobrescrita e não seja informado um valor para o atributo *cleanUpDays*  na entidade então é utilizado o padrão de 10 dias ou então o que estiver definido na configuração *cleanUpDays* presente na configuração *photoGallery*.
* ``disableDelete`` : Determina se o usuário pode excluir as fotos presentes na galeria no momento que a galeria for exibida, caso o atributo não esteja presente por padrão o usuário pode excluir as fotos da galeria.

------
Langs :
------

* ``FixedKeyPhotoGalleryTitle`` : Exibida como título da ação que aciona a câmera para adicionar fotos na galeria. (Padrão: Fotos para galeria)
* ``FixedKeyPhotoGalleryPictureTaked`` : Exibida quando uma nova foto foi salva na galeria. (Padrão: Foto gravada na galeria!)
* ``FixedKeyUsePictureFromGallery`` : Exibida quando existe a opção de utilizar fotos da galeria. (Padrão: Escolher foto da galeria?)
* ``FixedKeyNoPictureToShowOnGallery`` : Exibida quando existe a opção de utilizar fotos da galeria mas não existem fotos para exibir na galeria. (Padrão: Não há fotos na galeria!)
* ``FixedKeyCommandDelete`` : Exibida nas ações que executam a remoção ou exclusão de algum elemento. (Padrão: Excluir)

-----------------------------------
Fotos da Utilização da Funcionalidade:
-----------------------------------

.. figure:: ../images/photogallery/menuoption.png
   :height: 400px
   :width: 240px
   :align: left
   
   Exibição da opção que é adicionada ao menu superior para que seja possível salvar novas fotos na galeria. (Foto para galeria)


.. figure:: ../images/photogallery/takingphototogallery.png
   :height: 400px
   :width: 240px
   :align: left
   
   Exibição de uma nova foto sendo tirada para ser adicionada à galeria


.. figure:: ../images/photogallery/photosavedongallery.png
   :height: 400px
   :width: 240px
   :align: left
   
   Mensagem indicando que a foto foi salva na galeria para ser usada posteriormente em um apontamento


.. figure:: ../images/photogallery/cameraorgallery.png
   :height: 400px
   :width: 240px
   :align: left
   
   Quando o fluxo requerer uma imagem a ser salva no apontamento será exida a opção para o usuário para indicar se deseja tirar uma nova foto ou selecionar uma foto da galeria, caso não hajam fotos para serem exibidas na galeria o aplicativo então direciona o usuário diretamente para a câmera.   


.. figure:: ../images/photogallery/galleryvisualization.png
   :height: 400px
   :width: 240px
   :align: left
   
   Exibição das fotos na galeria para que possam ser selecionadas pelo usuário   


.. figure:: ../images/photogallery/photodeletion.png
   :height: 400px
   :width: 240px
   :align: left
   
   Caso o a opção de exclusão das fotos não esteja desativada nas configurações o usuário pode selecionar as fotos que deseja excluir, primeiro é necessário pressionar uma foto até que ela apareça selecionada (em azul) e então é necessário clicar nas demais fotos caso se deseje excluir mais de uma foto. Após ter selecionado as fotos o usuário deve selecionar a opção *Excluir* para remover as fotos.


.. figure:: ../images/photogallery/fotovisualization.png
   :height: 400px
   :width: 240px
   :align: left
   
   Caso o usuário selecione uma foto; sem a opção de seleção de fotos para exluir ativada, o aplicativo então direciona o usuário para uma visualização maior da foto para que confirme a seleção da imagem para o apontamento.