InkManager.LoadAsync(IInputStream) Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Input.Inking

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Nota

Per l'app di Windows universale con Extensible Application Markup Language (XAML), è consigliabile usare InkPresenter e il controllo InkCanvas anziché InkManager.

Carica in modo asincrono tutti gli oggetti InkStroke dal flusso specificato all'insieme InkStroke gestito da InkManager.

I dati penna vengono serializzati come metadati ISF (Ink Serialized Format) e incorporati in un file 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)

Parametri

inputStream: IInputStream

Flusso contenente l'insieme di tratti. È possibile specificare invece un oggetto IRandomAccessStream (richiede IOutputStream).

Restituisce

IAsyncActionWithProgress<UInt64>

Windows.Foundation.IAsyncActionWithProgress

IAsyncActionWithProgress<uint64_t>

Stato dell'operazione asincrona come numero di byte recuperati. Per altre informazioni, vedere Metodo ReadAsync .

Implementazioni

LoadAsync(IInputStream)

Attributi: RemoteAsyncAttribute

Esempio

La loadStrokes funzione in questo esempio illustra come:

Visualizzare una schermata aperta del file in cui il tipo di file è vincolato al formato GIF (Graphics Interchange Format) usando l'oggetto FileOpenPicker .
Configurare un flusso di input tramite il metodo OpenAsync .
Utilizzare il metodo LoadAsync di un oggetto InkManager (inkManager) per de serializzare i dati dell'input penna da un file 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();
                            }
                        });
            }
        });
}

Commenti

L'incorporamento dei metadati in un file GIF (Graphics Interchange Format) consente di visualizzare l'input penna nelle applicazioni non abilitate per l'input penna, mantenendo la fedeltà completa per le applicazioni abilitate per l'input penna. Questo formato è ideale per il trasporto del contenuto penna all'interno di un file HTML e renderlo utilizzabile da applicazioni input penna e non penna.

Nota

Ink Serialized Format (ISF) è la rappresentazione più compatta dell'input penna. Può essere incorporato all'interno di un formato di documento binario o posizionato direttamente negli Appunti mantenendo diverse proprietà penna, ad esempio pressione, larghezza, colore, inclinazione, rotazione e così via.

Si applica a

Condividi tramite