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 nei sistemi operativi Microsoft Windows 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/modalità di modifica. |
| 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 per 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 utilizzato 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 input e riconosciuto se è installato Windows Vista o XP Tablet PC Edition 2005.
- Anche i movimenti possono essere riconosciuti.
- La scrittura a mano 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 l'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 hanno installato solo Windows XP Tablet PC Edition Software Development Kit (SDK). Gli oggetti InkDisp possono essere convertiti solo in testo (riconosciuto), se Windows Vista o 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 attivato 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 oggetto GroupBox impostato su trasparente, InkPicture non raccoglierà l'input penna. InkPicture deve essere il controllo più alto nell'ordine Z oppure deve essere figlio di GroupBox.
Implementazione COM
Questo oggetto implementa l'interfaccia COM IInkPicture .