Udostępnij za pośrednictwem


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.

dokumentacja formantu InkEdit

klasy inkOverlay