Intent.ActionGetContent Campo

Definição

Namespace:

Android.Content

Assembly:

Mono.Android.dll

Ação de atividade: Permite que o usuário selecione um tipo específico de dados e os retorne.

[Android.Runtime.Register("ACTION_GET_CONTENT")]
public const string ActionGetContent;

[<Android.Runtime.Register("ACTION_GET_CONTENT")>]
val mutable ActionGetContent : string

Valor do campo

String

Implementações

ContentsFileDescriptor

Atributos

RegisterAttribute

Comentários

Ação de atividade: Permite que o usuário selecione um tipo específico de dados e os retorne. Isso é diferente do #ACTION_PICK que aqui dizemos apenas que tipo de dados é desejado, não um URI de dados existentes dos quais o usuário pode escolher. Um ACTION_GET_CONTENT pode permitir que o usuário crie os dados enquanto eles são executados (por exemplo, tirar uma foto ou gravar um som), deixá-los navegar pela web e baixar os dados desejados, etc.

Há duas maneiras principais de usar essa ação: se você quiser um tipo específico de dados, como um contato pessoal, defina o tipo MIME para o tipo de dados desejado e inicie-o com Context#startActivity(Intent)o . O sistema então lançará o melhor aplicativo para selecionar esse tipo de dados para você.

Você também pode estar interessado em qualquer um de um conjunto de tipos de conteúdo que o usuário pode escolher. Por exemplo, um aplicativo de email que deseja permitir que o usuário adicione um anexo a uma mensagem de email pode usar essa ação para exibir uma lista de todos os tipos de conteúdo que o usuário pode anexar.

Nesse caso, você deve encapsular a intenção GET_CONTENT com um seletor (através #createChooserde ), que dará a interface adequada para o usuário escolher como enviar seus dados e permitir que você especifique um prompt indicando o que está fazendo. Normalmente, você especificará um tipo MIME amplo (como image/* ou */*), resultando em uma ampla variedade de tipos de conteúdo que o usuário pode selecionar.

Ao usar uma ação GET_CONTENT tão ampla, muitas vezes é desejável escolher apenas dados que podem ser representados como um fluxo. Isso é feito exigindo o #CATEGORY_OPENABLE na Intenção.

Os chamadores podem, opcionalmente, especificar #EXTRA_LOCAL_ONLY para solicitar que o seletor de conteúdo iniciado retorne apenas resultados que representem dados que estão disponíveis localmente no dispositivo. Por exemplo, se esse extra estiver definido como true, um seletor de imagens não deverá mostrar nenhuma imagem disponível em um servidor remoto, mas que ainda não esteja no dispositivo local (exigindo, portanto, que elas sejam baixadas quando abertas).

Se o chamador puder manipular vários itens retornados (o usuário executando várias seleções), ele poderá especificar #EXTRA_ALLOW_MULTIPLE para indicar isso.

Entrada: #getType é o tipo MIME desejado para recuperar. Observe que nenhum URI é fornecido na intenção, pois não há restrições sobre de onde os dados retornados vêm originalmente. Você também pode incluir o #CATEGORY_OPENABLE if você só pode aceitar dados que podem ser abertos como um fluxo. Você pode usar #EXTRA_LOCAL_ONLY para limitar a seleção de conteúdo a dados locais. Você pode usar #EXTRA_ALLOW_MULTIPLE para permitir que o usuário selecione vários itens.

Saída: o URI do item que foi selecionado. Este deve ser um conteúdo: URI para que qualquer receptor possa acessá-lo.

Documentação Java para android.content.Intent.ACTION_GET_CONTENT.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.