InkPresenter.ActivateCustomDrying Metodo

  • Riferimento

Definizione

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

Indica che l'app richiede il controllo completo del rendering dell'input penna.

Per impostazione predefinita, l'input penna viene elaborato in un thread in background a bassa latenza e durante il disegno del tratto ne viene eseguito il rendering "intermedio". Quando il tratto viene completato (penna o dito sollevato o pulsante del mouse rilasciato), il tratto viene elaborato sul thread dell'interfaccia utente e viene eseguito il rendering "asciutto" al livello di rendering (sopra il contenuto dell'applicazione e sostituendo l'inchiostro bagnato).

Modelli di hosting di InkPresenter

InkCanvas

Chiamando ActivateCustomDrying (prima che sia caricato il controllo InkCanvas), un'app crea un oggetto InkSynchronizer per personalizzare la modalità di esecuzione del rendering definitivo di un tratto input penna in un oggetto SurfaceImageSource o VirtualSurfaceImageSource. Ad esempio, un tratto input penna può essere rasterizzato e integrato nel contenuto dell'applicazione anziché come livello InkCanvas separato.

InkDesktopHost (Windows 10 versione 1511 e versioni successive)

Le app Win32 possono ospitare un InkPresenter in un oggettoInkDesktopHost usando l'albero visivo DirectComposition.

Ciò richiede un oggetto IInkD2DRenderer per gestire l'input penna (vedere l'esempio di input penna complesso).

CoreInkPresenterHost (Windows 10 Fall Creators Update e versioni successive)

Ospitare un InkPresenter nel proprio Windows.UI.Albero di composizione senza un controllo InkCanvas associato.

public:
 virtual InkSynchronizer ^ ActivateCustomDrying() = ActivateCustomDrying;
InkSynchronizer ActivateCustomDrying();
public InkSynchronizer ActivateCustomDrying();
function activateCustomDrying()
Public Function ActivateCustomDrying () As InkSynchronizer

Restituisce

InkSynchronizer

Oggetto utilizzato per il rendering personalizzato del tratto penna.

Commenti

Codici di errore

E_ILLEGAL_METHOD_CALL (0x8000000E)

Generato se ActivateCustomDrying viene chiamato dopo il caricamento di InkCanvas .

Questo metodo deve essere chiamato prima del caricamento di InkCanvas.

L'essicazione personalizzata e la barra InkToolbar
Per impostazione predefinita, l'input penna viene elaborato in un thread in background a bassa latenza e durante il disegno del tratto ne viene eseguito il rendering "intermedio". Una volta completato il tratto (ovvero sollevata la penna/il dito o rilasciato il pulsante del mouse), il tratto viene elaborato nel thread dell'interfaccia utente e ne viene eseguito il rendering "definitivo" nel livello InkCanvas (sopra il contenuto dell'applicazione e in sostituzione dell'input penna intermedio). La piattaforma di input penna consente di ignorare questo comportamento e personalizzare completamente l'esperienza di input penna personalizzando il rendering definitivo.

Se l'app esegue l'override del comportamento di rendering input penna predefinito di InkPresenter con un'implementazione personalizzata di scorrimento, i tratti penna di cui è stato eseguito il rendering non sono più disponibili per InkToolbar e i comandi predefiniti di cancellazione di InkToolbar non funzionano come previsto. Per offrire funzionalità di cancellazione, è necessario gestire tutti gli eventi puntatore, eseguire l'hit testing su ogni tratto ed eseguire l'override del comando predefinito "Cancella tutto l'input penna".

Per altre info sulla personalizzazione del rendering definitivo, vedi Interazioni tramite penna e Windows Ink nelle app UWP.

Si applica a

Vedi anche