Dokumentacja formantu InkPicture
Kontrolka InkPicture umożliwia umieszczenie obrazu w aplikacji i umożliwienie użytkownikom dodawania pisma odręcznego. Jest przeznaczony dla scenariuszy, w których atrament nie jest rozpoznawany jako tekst, ale zamiast tego jest przechowywany jako atrament.
Kontrolkę InkPicture można utworzyć, wywołując metodę CoCreateInstance w języku C++.
Nuta
Kontrolka InkPicture nie jest oznaczona jako bezpieczna dla skryptów. Kontrolka InkPicture nie powinna być używana na stronach HTML ani ASP.NET.
Utworzenie kontrolki InkPicture za przezroczystą kontrolką (na przykład GroupBox z zestawem właściwości WS_EX_TRANSPARENT) uniemożliwi zbieranie pisma odręcznego inkPicture.
Członków
| Wyliczenie | Opis |
|---|---|
| InkPictureSizeMode | Definiuje wartości określające sposób działania obrazu tła wewnątrz kontrolki InkPicture. |
| Zdarzenie | Opis |
|---|---|
| changeUICues | Przestarzałe. |
| kliknij | Występuje, gdy użytkownik kliknie kontrolkę InkPicture. |
| CursorButtonDown Event | Występuje, gdy kontrolka InkCollector wykrywa obiektIInkCursorButton, który nie działa. |
| CursorButtonUp Event | Występuje, gdy kontrolka InkPicture wykrywa IInkCursorButton, która jest w górę. |
| zdarzeń CursorDown | Występuje, gdy wskazówka kursora kontaktuje się z cyfry powierzchni tabletu. |
| CursorInRange Event | Występuje, gdy kursor przechodzi do zakresu wykrywania fizycznego (zbliżenia) kontekstu tabletu. |
| CursorOutOfRange Event | Występuje, gdy kursor opuszcza zakres wykrywania fizycznego (bliskość) kontekstu tabletu. |
| DblClick | Występuje po dwukrotnym kliknięciu kontrolki InkPicture. Ta metoda zdarzenia jest zdefiniowana w interfejsie _IInkPictureEvents. Interfejs _IInkPictureEvents implementuje interfejs IDispatch z identyfikatorem DISPID_IPEDblClick. |
| zdarzenia gestu | Występuje po rozpoznaniu gestu aplikacji. |
| zdarzenie KeyDown [Kontrolka InkPicture] | Występuje po naciśnięciu i w pozycji w dół, gdy kontrolka InkPicture ma fokus. |
| KeyPress Event[InkPicture Control] | Występuje po naciśnięciu, gdy kontrolka InkPicture ma fokus. |
| KeyUp Event [InkPicture Control] | Występuje, gdy klucz jest zwalniany, gdy kontrolka InkPicture ma fokus. |
| zdarzenie MouseDown [InkPicture Control] | Występuje, gdy wskaźnik myszy znajduje się na kontrolce InkPicture, a naciśnięty jest przycisk myszy. |
| MouseEnter | Występuje, gdy wskaźnik myszy przechodzi do kontrolki InkPicture. |
| MouseHover | Występuje po umieszczeniu wskaźnika myszy nad kontrolką InkPicture. |
| MouseLeave | Występuje, gdy wskaźnik myszy opuszcza kontrolkę InkPicture. |
| MouseMove Event [InkPicture Control] | Występuje, gdy wskaźnik myszy jest przenoszony przez kontrolkę InkPicture. |
| zdarzenie MouseUp [Kontrolka InkPicture] | Występuje, gdy wskaźnik myszy znajduje się nad kontrolką InkPicture i jest zwalniany przycisk myszy. |
| MouseWheel | Występuje, gdy koło myszy porusza się, gdy kontrolka InkPicture ma fokus. |
| zdarzeń NewInAirPackets | Występuje, gdy jest widoczny pakiet w powietrzu. |
| zdarzeń NewPackets | Występuje, gdy kontrolka InkPicture odbiera pakiet. |
| malowane | Występuje, gdy kontrolka InkPicture została zakończona ponowne rysowanie. |
| malowanie | Występuje przed ponownym rysowanie kontrolki InkPicture. |
| Zmienianie rozmiaru | Występuje po zmianie rozmiaru kontrolki InkPicture. |
| SelectionChanged | Występuje, gdy wybór tekstu w kontrolce InkPicture uległ zmianie, na przykład poprzez zmiany interfejsu użytkownika, procedury wycinania i wklejania lub właściwości Selection. |
| SelectionChanging | Występuje, gdy wybór tekstu w kontrolce InkPicture ma ulec zmianie, na przykład poprzez zmiany interfejsu użytkownika, procedury wycinania i wklejania lub właściwości Selection. |
| Wybór | Występuje, gdy pozycja bieżącego zaznaczenia uległa zmianie, na przykład przez zmiany interfejsu użytkownika, procedury wycinania i wklejania lub właściwości Selection. |
| SelectionMoving Event [InkPicture Control] | Występuje, gdy pozycja bieżącego zaznaczenia ma ulec zmianie, na przykład poprzez zmiany interfejsu użytkownika, procedury wycinania i wklejania lub właściwości Selection. |
| SelectionResized | Występuje, gdy rozmiar bieżącego zaznaczenia uległ zmianie, na przykład przez zmiany interfejsu użytkownika, procedury wycinania i wklejania lub właściwości Selection. |
| SelectionResizing | Występuje, gdy rozmiar bieżącego zaznaczenia ma ulec zmianie, na przykład przez zmiany interfejsu użytkownika, procedury wycinania i wklejania lub właściwości Selection. |
| SizeChanged | Występuje po zmianie rozmiaru kontrolki InkPicture, w szczególności po zmianie wartości właściwości Width lub Height. |
| SizeModeChanged | Występuje po zmianie właściwości SizeMode kontrolki InkPicture. |
| StyleChanged | Nie zaimplementowano. |
| pociągnięcia | Występuje, gdy użytkownik rysuje nowy pociągnięcie na dowolnym tablecie. |
| StrokesDeleted | Występuje po usunięciu obiektów IInkStrokeDisp z właściwościpisma odręcznego. |
| StrokesDeleting | Występuje przed usunięciem obiektówIInkStrokeDisp z właściwości ink. |
| SystemColorsChanged | Występuje po zmianie kolorów systemu. |
| SystemGesture | Występuje po rozpoznaniu gestu systemowego. |
| TabletDodajne zdarzeń | Występuje po dodaniu tabletu do systemu. |
| TabletRemoved Event | Występuje po usunięciu tabletu z systemu. |
| Metoda | Opis |
|---|---|
| metody GetEventInterest | Zwraca wartość wskazującą, czy kontrolka InkPicture ma zainteresowanie określonym zdarzeniem. |
| GetGestureStatus | Zwraca wartość wskazującą, czy kontrolka InkPicture interesuje się określonym gestem aplikacji. |
| getWindowInputRectangle, metoda | Zwraca prostokąt okna w pikselach, w których jest rysowany atrament. |
| HitTestSelection | Zwraca element członkowski SelectionHitResult wyliczenia, który określa, która część zaznaczenia, jeśli istnieje, została osiągnięta podczas testu trafienia. |
| SetAllTabletsMode, metoda | Umożliwia kontrolce InkPicture zbieranie pisma odręcznego z dowolnego tabletu dołączonego do komputera Tablet. |
| SetEventInterest, metoda | Ustawia wartość wskazującą, czy kontrolka InkPicture ma zainteresowanie określonym zdarzeniem. |
| SetFocus | Przenosi fokus do kontrolki InkPicture. |
| SetGestureStatus, metoda | Ustawia zainteresowanie obiektu InkPicture w określonym gestu aplikacji. |
| SetSingleTabletIntegratedMode, metoda | Ustawia kontrolkę InkPicture w celu zbierania pisma odręcznego tylko z jednego tabletu dołączonego do komputera Tablet. Atrament z innych tabletów jest ignorowany. |
| SetWindowInputRectangle, metoda | Określa prostokąt okna, który ma być ustawiony, we współrzędnych okna, w których jest rysowany atrament. |
| ShowWhatsThis | Wyświetla wybrany temat w pliku Pomocy przy użyciu wyskakującego okienka "Co to" dostarczonego przez Pomoc w 32-bitowych systemach operacyjnych Microsoft Windows (tylko czas projektowania). |
| ZOrder | Umieszcza kontrolkę na przednim lub tylnym rogu kolejności z na poziomie graficznym (tylko czas projektowania). |
| Własność | Opis |
|---|---|
| właściwości autoredraw | Pobiera lub ustawia wartość określającą, czy kontrolka InkPicture jest odświeżona po unieważnieniu okna (czy obiekt InkDisp aktualnie skojarzony z kontrolką InkPicture jest automatycznie ponownie rysowany, gdy okno skojarzone z inkPicture odbiera komunikat WM_PAINT). |
| BackColor | Pobiera lub ustawia kolor tła kontrolki InkPicture. Domyślny kolor tła to kolor tła okna systemowego, który zazwyczaj jest biały. |
| właściwościCollectingInk | Pobiera wartość określającą, czy kontrolka InkPicture zbiera atrament (tylko czas wykonywania). |
| CollectionMode | Pobiera lub ustawia tryb zbierania, który określa, czy pisma odręczne, gesty lub gesty są rozpoznawane jako zapisy użytkownika. |
| właściwości kursorów | Pobiera kolekcję IInkCursors do użycia w regionie pisma odręcznego kontrolki InkPicture. |
| CustomStrokes | Pobiera kolekcję IInkCustomStrokes, która ma być utrwalana przy użyciu pisma odręcznego (tylko czas projektowania). |
| właściwość DefaultDrawingAttributes | Pobiera lub ustawia domyślną inkDrawingAttributes kolekcji do użycia podczas rysowania i wyświetlania pisma odręcznego (tylko czas wykonywania). |
| właściwości DesiredPacketDescription | Pobiera lub ustawia opis pakietu kontrolki InkPicture (tylko czas wykonywania). |
| właściwość DynamicRendering | Pobiera lub ustawia wartość określającą, czy kontrolka InkPicture dynamicznie renderuje atrament podczas zbierania. |
| EditingMode | Pobiera lub ustawia wartość określającą, czy kontrolka InkPicture jest w trybie pisma odręcznego, w trybie usuwania, czy w trybie wybierania/edytowania. |
| włączone | Pobiera lub ustawia wartość określającą, czy kontrolka InkPicture może reagować na zdarzenia generowane przez użytkownika. Uwaga: Ta właściwość jest równoważna właściwości InkEnabled. |
| EraserMode | Pobiera lub ustawia wartość określającą, czy atrament jest usuwany przez pociągnięcie, czy przez punkt. |
| EraserWidth | Pobiera lub ustawia wartość określającą szerokość pióra gumki. |
| hWnd | Pobiera uchwyt okna, do którego jest powiązana kontrolka InkPicture. (tylko czas wykonywania) |
| pisma odk | Pobiera lub ustawia obiekt InkDisp skojarzony z kontrolką InkPicture (tylko czas wykonywania). |
| InkEnabled | Pobiera lub ustawia wartość określającą, czy kontrolka InkPicture zbiera dane wejściowe pióra (pakiety w powietrzu, kursor w zdarzeniach zakresu itd.). |
| właściwości MarginX | Pobiera lub ustawia margines osi x wokół prostokąta okna we współrzędnych ekranu. |
| właściwościMarginY | Pobiera lub ustawia margines osi y wokół prostokąta okna we współrzędnych ekranu. |
| właściwości MouseIcon | Pobiera lub ustawia bieżącą niestandardową ikonę myszy. |
| właściwościMousePointer | Pobiera lub ustawia wartość wskazującą typ wskaźnika myszy, który pojawia się, gdy mysz znajduje się nad określoną częścią kontrolki InkPicture. |
| obrazów | Pobiera plik graficzny wyświetlany w kontrolce InkPicture. |
| właściwości modułu renderowania | Pobiera lub ustawia obiekt InkRenderer używany do rysowania pisma odręcznego w kontrolce InkPicture (tylko czas wykonywania). |
| wybór | Pobiera kolekcję InkStrokes aktualnie wybraną wewnątrz kontrolki InkPicture (tylko czas wykonywania). |
| SizeMode | Pobiera lub ustawia sposób obsługi umieszczania i określania rozmiaru obrazu przez kontrolkę. |
| SupportHighContrastInk, właściwość | Pobiera wartość określającą, czy atrament jest renderowany jako tylko jeden kolor, Kolor = COLOR_WINDOWTEXT (z wywołania GetSystemMetrics), gdy system jest w trybie dużego kontrastu. |
| SupportHighContrastSelectionUI | Pobiera lub ustawia wartość określającą, czy wszystkie interfejsy użytkownika wyboru (pole ograniczenia zaznaczenia i uchwyty wyboru) są rysowane w dużym kontraście, gdy system jest w trybie dużego kontrastu. |
| właściwości tabletu | Pobiera obiekt IInkTablet używany przez kontrolkę InkPicture do zbierania danych wejściowych. |
Uwagi
Interfejs użytkownika czasu wykonywania dla kontrolki InkPicture jest oknem z nieprzezroczystym tłem (pojedynczym kolorem, tłem obrazu lub obydwoma) zawierającym nieprzezroczyste pismo odręczne.
Możesz użyć kontrolki InkPicture do renderowania pisma odręcznego w systemie Microsoft Windows 2000, Windows Server 2003, dowolnej wersji systemu Windows XP innej niż Windows XP Tablet PC Edition i dowolnej wersji systemu Windows Vista. Można jednak wprowadzić pismo odręczne, zaakceptować gesty lub rozpoznać pismo ręczne tylko w następujących warunkach:
- Atrament może być wejściowy i rozpoznawany, jeśli jest zainstalowany system Windows Vista lub XP Tablet PC Edition 2005.
- Gesty można również rozpoznać.
- Pisanie ręczne może być rozpoznawane jako tekst, jeśli pismo ręczne pochodzi z maszyn z starszymi wersjami systemu Windows, o ile są obecne rozpoznawania.
Jeśli używasz systemu Windows 2000, Windows Server 2003, dowolnej wersji systemu Windows XP innej niż Windows XP Tablet PC Edition 2005, możesz przypisać wartości do właściwości otoczenia kontrolki InkPicture, a następnie skopiować i wkleić atrament do innych aplikacji. Jednak wartość jej właściwości InkEnabled zawsze będzie FALSE.
Utrwalone obiekty InkDisp można ładować i wyświetlać we wszystkich wersjach systemu Windows Vista i XP oraz w systemach z zainstalowanym tylko zestawem Sdk (Software Development Kit) systemu Windows XP Tablet PC Edition. InkDisp obiektów można przekonwertować tylko na tekst (rozpoznawany), jeśli jest zainstalowany system Windows Vista lub Windows XP Tablet PC Edition 2005.
Jeśli operacje na tej kontrolce nie powiedzą się, zwracany jest legalny element HRESULT. Jeśli wynik warunków błędu, sprawdź zwrócony wynik HRESULT względem błędu.
Aby uzyskać więcej informacji na temat kontrolek pisma oddyskowego, zobacz pisma odk.
Aby uzyskać informacje o tym, które wątki wywołują określone zdarzenia, zobacz Wątki, na których zdarzenie może wyzwalać.
Aby poprawić wydajność aplikacji, należy ręcznie usunąć kontrolkę InkPicture, gdy nie jest już potrzebna.
Nuta
Gdy kontrolka InkPicture jest nakładana na inną kontrolkę, taką jak GroupBox ustawiona na przezroczystą, inkPicture nie będzie zbierać pisma odręcznego. InkPicture musi być najbardziej górną kontrolką w kolejności Z lub musi być elementem podrzędnym GroupBox.
Implementacja modelu COM
Ten obiekt implementuje interfejs IInkPicture COM.