InkManager.LoadAsync(IInputStream) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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
- Atributos
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.
Se aplica a
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