InkManager.LoadAsync(IInputStream) Méthode

Référence

Définition

Espace de noms:: Windows.UI.Input.Inking

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Notes

Pour l’application Windows universelle utilisant le langage XAML (Extensible Application Markup Language), nous vous recommandons d’utiliser InkPresenter et le contrôle InkCanvas au lieu d’InkManager.

Charge de manière asynchrone tous les objets InkStroke du flux spécifié dans la collection InkStroke gérée par InkManager.

Les données manuscrites sont sérialisées en tant que métadonnées ISF (Ink Serialized Format) et incorporées dans un fichier 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)

Paramètres

inputStream: IInputStream

Flux qui contient la collection de traits. Un objet IRandomAccessStream (nécessite IOutputStream) peut être spécifié à la place.

Retours

IAsyncActionWithProgress<UInt64>

Windows.Foundation.IAsyncActionWithProgress

IAsyncActionWithProgress<uint64_t>

Le status de l’opération asynchrone comme nombre d’octets extraits. Pour plus d’informations, consultez Méthode ReadAsync .

Implémente

LoadAsync(IInputStream)

Attributs: RemoteAsyncAttribute

Exemples

La loadStrokes fonction de cet exemple montre comment :

Affichez un écran d’ouverture de fichier où le type de fichier est limité au format GIF (Graphics Interchange Format) à l’aide de l’objet FileOpenPicker .
Configurez un flux d’entrée via la méthode OpenAsync .
Utilisez la méthode LoadAsync d’un objet InkManager (inkManager) pour dé sérialiser les données manuscrites d’un fichier 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();
                            }
                        });
            }
        });
}

Remarques

L’incorporation des métadonnées dans un fichier GIF (Graphics Interchange Format) permet d’afficher l’entrée manuscrite dans les applications qui ne sont pas compatibles avec l’entrée manuscrite tout en conservant une fidélité totale pour les applications avec entrée manuscrite. Ce format est idéal pour transporter le contenu manuscrit dans un fichier HTML et le rendre utilisable par les applications manuscrites et non manuscrites.

Notes

Le format sérialisé manuscrit (ISF) est la représentation persistante la plus compacte de l’entrée manuscrite. Il peut être incorporé dans un format de document binaire ou placé directement dans le Presse-papiers tout en préservant diverses propriétés d’encre telles que la pression, la largeur, la couleur, l’inclinaison, la torsion, etc.

S’applique à

Partager via