InkManager.LoadAsync(IInputStream) Método

Definición

Espacio de nombres:

Windows.UI.Input.Inking

Nota

En el caso de la aplicación universal de Windows con lenguaje xaml de aplicación extensible, se recomienda usar InkPresenter y el control InkCanvas en lugar de InkManager.

Carga asincrónicamente todos los objetos InkStroke de la secuencia especificada a la colección InkStroke administrada por InkManager.

Los datos de entrada de lápiz se serializan como metadatos de formato serializado de entrada de lápiz (ISF) e incrustados en un archivo de formato de intercambio de gráficos (GIF).

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

Secuencia que contiene la colección de trazos. En su lugar, se puede especificar un objeto IRandomAccessStream (requiere IOutputStream).

Devoluciones

IAsyncActionWithProgress<UInt64>

Windows.Foundation.IAsyncActionWithProgress

IAsyncActionWithProgress<uint64_t>

Estado de la operación asincrónica como el número de bytes capturados. Para obtener más información, vea Método ReadAsync .

Implementaciones

LoadAsync(IInputStream)

Atributos

RemoteAsyncAttribute

Ejemplos

La loadStrokes función de este ejemplo muestra cómo:

• Muestra una pantalla de apertura de archivo en la que el tipo de archivo está restringido al formato de formato de intercambio de gráficos (GIF) mediante el objeto FileOpenPicker .
• Configure un flujo de entrada a través del método OpenAsync .
• Utilice el método LoadAsync de un objeto InkManager (inkManager) para des serializar los datos de entrada de lápiz de un archivo de formato de intercambio de gráficos (storageFileGIF).

// 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();
                            }
                        });
            }
        });
}

Comentarios

La inserción de los metadatos en un archivo de formato de intercambio de gráficos (GIF) permite ver la entrada de lápiz en aplicaciones que no están habilitadas para entrada de lápiz, a la vez que se mantiene la fidelidad completa para las aplicaciones habilitadas para entrada de lápiz. Este formato es ideal para transportar contenido de entrada de lápiz dentro de un archivo HTML y hacer que sea utilizable por las aplicaciones de entrada de lápiz y no de lápiz.

Nota

El formato serializado de entrada de lápiz (ISF) es la representación persistente más compacta de la tinta. Se puede incrustar dentro de un formato de documento binario o colocarse directamente en el Portapapeles, conservando diversas propiedades de entrada de lápiz, como presión, ancho, color, inclinación, giro, etc.

Consulte también

• Interacciones de pluma y lápiz
• Introducción: Compatibilidad con la entrada de lápiz en la aplicación para UWP
• Ejemplo de análisis de entrada de lápiz (básico) (C#)
• Ejemplo de reconocimiento de escritura a mano de lápiz (C#)
• Guardar y cargar trazos de lápiz desde un archivo de formato serializado de entrada de lápiz (ISF)
• Guardar y cargar trazos de lápiz desde el Portapapeles
• Ejemplo de orientación y ubicación de la barra de herramientas de entrada de lápiz (básico)
• Ejemplo de orientación y ubicación de la barra de herramientas de entrada de lápiz (dinámica)
• Muestra de libro para colorear
• Muestra de notas familiares
• Ejemplo de entrada manuscrita (JavaScript)
• Ejemplo de entrada manuscrita simple (C#/C++)
• Ejemplo de entrada manuscrita compleja (C++)
• Ejemplo de análisis de entrada de lápiz