InkManager.LoadAsync(IInputStream) Método

Definição

Namespace:

Windows.UI.Input.Inking

Observação

Para o aplicativo Universal do Windows usando XAML (Extensible Application Markup Language), recomendamos usar InkPresenter e o controle InkCanvas em vez de InkManager.

Carrega de forma assíncrona todos os objetos InkStroke do fluxo especificado para a coleção InkStroke gerenciada pelo InkManager.

Os dados de tinta são serializados como metadados isf (formato serializado à tinta) e inseridos em um arquivo GIF (Graphics Interchange Format).

public:
 virtual IAsyncActionWithProgress<unsigned long long> ^ LoadAsync(IInputStream ^ inputStream) = LoadAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncActionWithProgress<uint64_t> LoadAsync(IInputStream const& inputStream);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncActionWithProgress<ulong> LoadAsync(IInputStream inputStream);

function loadAsync(inputStream)

Public Function LoadAsync (inputStream As IInputStream) As IAsyncActionWithProgress(Of ULong)

Parâmetros

inputStream

IInputStream

O fluxo que contém a coleção de traços. Um objeto IRandomAccessStream (requer IOutputStream) pode ser especificado.

Retornos

IAsyncActionWithProgress<UInt64>

Windows.Foundation.IAsyncActionWithProgress

IAsyncActionWithProgress<uint64_t>

O status da operação assíncrona como o número de bytes buscados. Para obter mais informações, consulte Método ReadAsync .

Implementações

LoadAsync(IInputStream)

Atributos

RemoteAsyncAttribute

Exemplos

A loadStrokes função neste exemplo demonstra como:

• Exiba uma tela de abertura de arquivo em que o tipo de arquivo é restrito ao formato GIF (Graphics Interchange Format) usando o objeto FileOpenPicker .
• Configure um fluxo de entrada por meio do método OpenAsync .
• Use o método LoadAsync de um objeto InkManager (inkManager) para desserializar os dados de tinta de um arquivo GIF (Graphics Interchange Format) (storageFile).

// Load strokes into an inkManager.
function loadStrokes()
{
    // Set up the file open screen.
    var openPicker = Windows.Storage.Pickers.FileOpenPicker();
    openPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.picturesLibrary;
    openPicker.fileTypeFilter.replaceAll([".gif"]);

    // Set up the stream.
    var loadStream = null;

    // Asynchronously load the ink data from the stream.
    openPicker.pickSingleFileAsync().done(
        function (file)
        {
            if (null != file)
            {
                file.openAsync(Windows.Storage.FileAccessMode.read).then(
                    function (stream) {
                        loadStream = stream;
                        return inkManager.loadAsync(loadStream);
                    }).done(
                        function()
                        {
                            var strokes = inkManager.getStrokes().length;
                            if (strokes === 0)
                            {
                                statusMessage.innerText = "No strokes in file.";
                            }
                            else
                            {
                                statusMessage.innerText = strokes + " strokes loaded.";
                            }
                            renderAllStrokes();
                            loadStream.close();
                        },
                        function (e)
                        {
                            statusMessage.innerText = "Load failed.";
                            if (loadStream)
                            {
                                // Close the stream if open.
                                loadStream.close();
                            }
                        });
            }
        });
}

Comentários

A inserção dos metadados em um arquivo GIF (Graphics Interchange Format) permite que a tinta seja exibida em aplicativos que não são habilitados para tinta, mantendo a fidelidade total para aplicativos habilitados para tinta. Esse formato é ideal para transportar conteúdo de tinta em um arquivo HTML e torná-lo utilizável por aplicativos à tinta e não à tinta.

Observação

O ISF (Formato Serializado à Tinta) é a representação persistente mais compacta da tinta. Ele pode ser inserido em um formato de documento binário ou colocado diretamente na Área de Transferência, preservando várias propriedades de tinta, como pressão, largura, cor, inclinação, torção e assim por diante.

Confira também

• Interações por caneta
• Introdução: oferecer suporte à tinta em seu aplicativo UWP
• Exemplo de análise de tinta (básico) (C#)
• Exemplo de reconhecimento de manuscrito à tinta (C#)
• Salvar e carregar traços de tinta de um arquivo ISF (Ink Serialized Format)
• Salvar e carregar traços de tinta da área de transferência
• Exemplo de localização e orientação da barra de ferramentas de tinta (básico)
• Exemplo de localização e orientação da barra de ferramentas de tinta (dinâmico)
• Exemplo de livro de colorir
• Exemplo de anotações da família
• Exemplo de escrita à tinta (JavaScript)
• Exemplo de escrita à tinta simples (C#/C++)
• Exemplo de escrita à tinta complexa (C++)
• Exemplo de análise de tinta