Informazioni di riferimento sul controllo InkPicture

Il controllo InkPicture offre la possibilità di inserire un'immagine in un'applicazione e consentire agli utenti di aggiungere input penna su di esso. È destinato agli scenari in cui l'input penna non viene riconosciuto come testo, ma viene archiviato come input penna.

È possibile creare un'istanza del controllo InkPicture chiamando il metodo CoCreateInstance in C++.

Nota

Il controllo InkPicture non è contrassegnato come sicuro per la creazione di script. Il controllo InkPicture non deve essere utilizzato nelle pagine HTML o ASP.NET.

La creazione del controllo InkPicture dietro un controllo trasparente (ad esempio un controllo GroupBox con il set di proprietà WS_EX_TRANSPARENT) impedisce a InkPicture di raccogliere l'input penna.

Membri

Enumerazione Descrizione
InkPictureSizeMode Definisce i valori che specificano il comportamento dell'immagine di sfondo all'interno del controllo InkPicture.
Event Descrizione
ChangeUICues Deprecato.
Fare clic su Si verifica quando un utente fa clic sul controllo InkPicture.
CursorButtonDown, evento Si verifica quando il controllo InkCollector rileva un oggetto IInkCursorButton inattivo.
CursorButtonUp, evento Si verifica quando il controllo InkPicture rileva un IInkCursorButton che è in funzione.
CursorDown, evento Si verifica quando la punta del cursore contatta la superficie del tablet digitalizzato.
CursorInRange, evento Si verifica quando un cursore entra nell'intervallo di rilevamento fisico (prossimità) del contesto del tablet.
CursorOutOfRange, evento Si verifica quando il cursore lascia l'intervallo di rilevamento fisico (prossimità) del contesto del tablet.
Dblclick Si verifica quando si fa doppio clic sul controllo InkPicture.
Questo metodo di evento è definito nell'interfaccia _IInkPictureEvents . L'interfaccia _IInkPictureEvents implementa l'interfaccia IDispatch con un identificatore di DISPID_IPEDblClick.
Evento Gesture Si verifica quando viene riconosciuto un movimento dell'applicazione.
Evento KeyDown [Controllo InkPicture] Si verifica quando viene premuto un tasto e nella posizione in giù mentre il controllo InkPicture ha lo stato attivo.
Evento KeyPress[Controllo InkPicture] Si verifica quando viene premuto un tasto mentre il controllo InkPicture ha lo stato attivo.
Evento KeyUp [Controllo InkPicture] Si verifica quando viene rilasciato un tasto mentre il controllo InkPicture ha lo stato attivo.
Evento MouseDown [Controllo InkPicture] Si verifica quando il puntatore del mouse si trova sul controllo InkPicture e viene premuto un pulsante del mouse.
Mouseenter Si verifica quando il puntatore del mouse entra nel controllo InkPicture.
MouseHover Si verifica quando il puntatore del mouse passa il mouse sul controllo InkPicture.
Mouseleave Si verifica quando il puntatore del mouse lascia il controllo InkPicture.
Evento MouseMove [Controllo InkPicture] Si verifica quando il puntatore del mouse viene spostato sul controllo InkPicture.
Evento MouseUp [Controllo InkPicture] Si verifica quando il puntatore del mouse si trova sul controllo InkPicture e viene rilasciato un pulsante del mouse.
Mousewheel Si verifica quando la rotellina del mouse si sposta mentre il controllo InkPicture ha lo stato attivo.
NewInAirPackets, evento Si verifica quando viene visualizzato un pacchetto in aria.
NewPackets, evento Si verifica quando il controllo InkPicture riceve un pacchetto.
Dipinto Si verifica quando il controllo InkPicture ha completato il ridisegno stesso.
Pittura Si verifica prima che il controllo InkPicture venga ridisegnato.
Ridimensionare Si verifica quando viene ridimensionato il controllo InkPicture.
SelectionChanged Si verifica quando la selezione del testo all'interno del controllo InkPicture è stata modificata, ad esempio tramite modifiche all'interfaccia utente, routine taglia e incolla o la proprietà Selection .
Selectionchanging Si verifica quando la selezione del testo all'interno del controllo InkPicture sta per cambiare, ad esempio tramite modifiche all'interfaccia utente, routine taglia e incolla o la proprietà Selection .
Selezione spostata Si verifica quando la posizione della selezione corrente è stata modificata, ad esempio tramite modifiche apportate all'interfaccia utente, alle routine taglia e incolla o alla proprietà Selection .
SelectionMoving Event [Controllo InkPicture] Si verifica quando la posizione della selezione corrente sta per cambiare, ad esempio tramite modifiche all'interfaccia utente, routine taglia e incolla o la proprietà Selection .
SelectionResized Si verifica quando le dimensioni della selezione corrente sono state modificate, ad esempio tramite modifiche apportate all'interfaccia utente, alle routine taglia e incolla o alla proprietà Selection .
Selectionresizing Si verifica quando la dimensione della selezione corrente sta per cambiare, ad esempio tramite modifiche apportate all'interfaccia utente, routine taglia e incolla o la proprietà Selection .
Sizechanged Si verifica dopo il ridimensionamento del controllo InkPicture, in particolare dopo la modifica del valore della proprietà Width o Height .
SizeModeChanged Si verifica dopo la modifica della proprietà SizeMode del controllo InkPicture.
Stylechanged Non implementato.
Infarto Si verifica quando l'utente disegna un nuovo tratto su qualsiasi tablet.
StrokesDeleted Si verifica dopo l'eliminazione degli oggetti IInkStrokeDisp dalla proprietà Ink .
StrokesDeleting Si verifica prima dell'eliminazione degli oggetti IInkStrokeDisp dalla proprietà Ink .
SystemColorsChanged Si verifica dopo la modifica dei colori di sistema.
SystemGesture Si verifica quando viene riconosciuto un movimento di sistema.
TabletAdded, evento Si verifica quando un tablet viene aggiunto al sistema.
TabletRemoved, evento Si verifica quando un tablet viene rimosso dal sistema.
Metodo Descrizione
Metodo GetEventInterest Restituisce un valore che indica se il controllo InkPicture ha interesse in un determinato evento.
GetGestureStatus Restituisce un valore che indica se il controllo InkPicture ha interesse in un determinato movimento dell'applicazione.
Metodo GetWindowInputRectangle Restituisce il rettangolo della finestra, in pixel, all'interno del quale viene disegnato l'input penna.
HitTestSelection Restituisce un membro dell'enumerazione SelectionHitResult , che specifica quale parte di una selezione, se presente, è stata raggiunta durante un hit test.
SetAllTabletsMode, metodo Consente al controllo InkPicture di raccogliere input penna da qualsiasi tablet collegato al TABLET.
SetEventInterest, metodo Imposta un valore che indica se un controllo InkPicture ha interesse in un evento specificato.
SetFocus Sposta lo stato attivo sul controllo InkPicture.
SetGestureStatus, metodo Imposta l'interesse dell'oggetto InkPicture in un movimento dell'applicazione specificato.
Metodo SetSingleTabletIntegratedMode Imposta il controllo InkPicture per raccogliere input penna da un solo tablet collegato al PC tablet. L'input penna da altri tablet viene ignorato.
Metodo SetWindowInputRectangle Specifica il rettangolo della finestra da impostare, nelle coordinate della finestra, all'interno del quale viene disegnato l'input penna.
ShowWhatsThis Visualizza un argomento selezionato in un file della Guida usando il popup "What's This" fornito dalla Guida in Microsoft Windows sistemi operativi a 32 bit (solo progettazione).
Zorder Posiziona il controllo sulla parte anteriore o posteriore dell'ordine z all'interno del relativo livello grafico (solo progettazione).
Proprietà Descrizione
AutoRedraw, proprietà Ottiene o imposta un valore che specifica se il controllo InkPicture esegue il repaint quando la finestra viene invalidata (se l'oggetto InkDisp attualmente associato al controllo InkPicture viene automaticamente ridisegnato quando la finestra associata a InkPicture riceve un messaggio di WM_PAINT).
Backcolor Ottiene o imposta il colore di sfondo per il controllo InkPicture. Il colore di sfondo predefinito è il colore di sfondo della finestra di sistema, che in genere è bianco.
CollectInk, proprietà Ottiene il valore che specifica se il controllo InkPicture raccoglie l'input penna (solo tempo di esecuzione).
CollectionMode Ottiene o imposta la modalità raccolta che determina se l'input penna, i movimenti o gli input penna vengono riconosciuti come scrive l'utente.
Cursori, proprietà Ottiene l'insieme IInkCursors disponibile per l'uso nell'area di input penna del controllo InkPicture.
CustomStrokes Ottiene l'insieme IInkCustomStrokes da rendere persistente con l'input penna (solo progettazione).
DefaultDrawingAttributes, proprietà Ottiene o imposta l'insieme InkDrawingAttributes predefinito da usare durante il disegno e la visualizzazione dell'input penna (solo tempo di esecuzione).
DesiredPacketDescription, proprietà Ottiene o imposta la descrizione del pacchetto del controllo InkPicture (solo runtime).
DynamicRendering, proprietà Ottiene o imposta il valore che specifica se il controllo InkPicture esegue in modo dinamico il rendering dell'input penna durante la raccolta.
ModificaMode Ottiene o imposta un valore che specifica se il controllo InkPicture è in modalità input penna, modalità di eliminazione o selezione/modifica della modalità.
Attivato Ottiene o imposta un valore che determina se il controllo InkPicture può rispondere agli eventi generati dall'utente.
[! Nota]
Questa proprietà equivale alla proprietà InkEnabled .

EraserMode Ottiene o imposta il valore che specifica se l'input penna viene cancellato per tratto o in base al punto.
EraserWidth Ottiene o imposta il valore che specifica la larghezza della punta della penna di cancellazione.
Hwnd Ottiene l'handle della finestra a cui è associato il controllo InkPicture. (solo tempo di esecuzione)
Input penna Ottiene o imposta l'oggetto InkDisp associato al controllo InkPicture (solo runtime).
InkEnabled Ottiene o imposta un valore che specifica se il controllo InkPicture raccoglie l'input penna (pacchetti in aria, cursori negli eventi di intervallo e così via).
MarginX, proprietà Ottiene o imposta il margine dell'asse x intorno al rettangolo della finestra nelle coordinate dello schermo.
MarginY, proprietà Ottiene o imposta il margine dell'asse y intorno al rettangolo della finestra nelle coordinate dello schermo.
MouseIcon, proprietà Ottiene o imposta l'icona del mouse personalizzata corrente.
MousePointer, proprietà Ottiene o imposta un valore che indica il tipo di puntatore del mouse visualizzato quando il mouse si trova su una determinata parte del controllo InkPicture.
Immagine Ottiene il file grafico da visualizzare nel controllo InkPicture.
Renderer, proprietà Ottiene o imposta l'oggetto InkRenderer usato per disegnare l'input penna nel controllo InkPicture (solo tempo di esecuzione).
Selezione Ottiene l'insieme InkStrokes attualmente selezionato all'interno del controllo InkPicture (solo runtime).
SizeMode Ottiene o imposta il modo in cui il controllo gestisce il posizionamento e il ridimensionamento delle immagini.
SupportHighContrastInk, proprietà Ottiene un valore che specifica se viene eseguito il rendering dell'input penna come un solo colore, Color = COLOR_WINDOWTEXT (dalla chiamata GetSystemMetrics) quando il sistema è in modalità a contrasto elevato.
SupportHighContrastSelectionUI Ottiene o imposta un valore che specifica se tutte le interfacce utente di selezione (casella di selezione e handle di selezione) vengono disegnate in contrasto elevato quando il sistema è in modalità a contrasto elevato.
Tablet, proprietà Ottiene l'oggetto IInkTablet attualmente usato dal controllo InkPicture per raccogliere l'input.

Commenti

L'interfaccia utente di runtime per il controllo InkPicture è una finestra con sfondo opaco (colore singolo, sfondo immagine o entrambi) che contiene input penna opaco.

È possibile usare il controllo InkPicture per eseguire il rendering dell'input penna in Microsoft Windows 2000, Windows Server 2003, qualsiasi edizione di Windows XP diversa da Windows XP Tablet PC Edition e qualsiasi versione di Windows Vista. Tuttavia, è possibile immettere input penna, accettare movimenti o riconoscere la grafia solo in base alle condizioni seguenti:

  • L'input penna può essere inserito e riconosciuto se è installato Windows Vista o XP Tablet PC Edition 2005.
  • Anche i movimenti possono essere riconosciuti.
  • La grafia può essere riconosciuta come testo se la grafia ha origine nei computer che eseguono versioni precedenti di Windows purché siano presenti i riconoscimento.

Se si usa Windows 2000, Windows Server 2003, qualsiasi edizione di Windows XP diversa da Windows XP Tablet PC Edition 2005, è possibile assegnare valori alle proprietà ambientali del controllo InkPicture, quindi copiare e incollare input penna in altre applicazioni. Tuttavia, il valore della proprietà InkEnabled sarà sempre FALSE.

Gli oggetti InkDisp persistenti possono essere caricati e visualizzati in tutte le edizioni di Windows Vista e XP e nei sistemi che dispongono solo dei Windows XP Tablet PC Edition Software Development Kit (SDK) installati. Gli oggetti InkDisp possono essere convertiti solo in testo (riconosciuto), se Windows Vista o l'Windows XP Tablet PC Edition 2005 è installato.

Se le operazioni su questo controllo non hanno esito positivo, viene restituito un HRESULT legale. Se si verifica una condizione di errore, controllare il valore HRESULT restituito rispetto all'errore.

Per altre informazioni sui controlli input penna, vedere Input penna.

Per informazioni sui thread che generano eventi specifici, vedere Thread su cui può essere generato un evento.

Per migliorare le prestazioni dell'applicazione, eliminare manualmente un controllo InkPicture quando non è più necessario.

Nota

Quando un controllo InkPicture viene sovrapposto a un altro controllo, ad esempio un controllo GroupBox impostato su trasparente, InkPicture non raccoglierà l'input penna. InkPicture deve essere il controllo più alto nell'ordine Z oppure deve essere un elemento figlio di GroupBox.

Implementazione COM

Questo oggetto implementa l'interfaccia COM IInkPicture .

Informazioni di riferimento sul controllo InkEdit

Classe InkOverlay