InkPicture Denetim Başvurusu
InkPicture denetimi, bir uygulamaya görüntü yerleştirme ve kullanıcıların üzerine mürekkep eklemesini sağlama olanağı sağlar. Bu, mürekkep metin olarak tanınmayan ancak bunun yerine mürekkep olarak depolandığı senaryolara yöneliktir.
InkPicture denetimi, C++'da CoCreateInstance yöntemi çağrılarak örneklenebilir.
Not
InkPicture denetimi betik oluşturma için güvenli olarak işaretlenmez. InkPicture denetimi HTML veya ASP.NET sayfalarında kullanılmamalıdır.
Saydam denetimin arkasında InkPicture denetiminin oluşturulması (WS_EX_TRANSPARENT özellik kümesine sahip bir GroupBox gibi) InkPicture'ın mürekkep toplamasını engeller.
Üyeler
| Sayım | Açıklama |
|---|---|
| InkPictureSizeMode | Arka plan resminin InkPicture denetiminde nasıl davranacağını belirten değerleri tanımlar. |
| Olay | Açıklama |
|---|---|
| ChangeUICues | Kaldırıl -mış. |
| 'a tıklayın | Kullanıcı InkPicture denetimine tıkladığında gerçekleşir. |
| CursorButtonDown Olayı |
InkCollector denetimi, bir IInkCursorButton nesnesi algıladığında oluşur. |
| CursorButtonUp Olay | InkPicture denetimi bir IInkCursorButton algıladığında gerçekleşir. |
| CursorDown Olayı | İmleç ucu dijitalleşen tablet yüzeyine temas ettiğinde gerçekleşir. |
| CursorInRange Olay | İmleç tablet bağlamının fiziksel algılama aralığına (yakınlık) girdiğinde gerçekleşir. |
| CursorOutOfRange Olay | İmleç tablet bağlamının fiziksel algılama aralığından (yakınlık) ayrıldığında gerçekleşir. |
| DblClick | InkPicture denetimine çift tıklandığında gerçekleşir. Bu olay yöntemi _IInkPictureEvents arabiriminde tanımlanır. _IInkPictureEvents arabirimi, DISPID_IPEDblClick tanımlayıcısıyla IDispatch arabirimini uygular. |
| Hareket Olayı | Bir uygulama hareketi tanındığında gerçekleşir. |
| KeyDown Olayı [InkPicture Denetimi] | InkPicture denetimi odaktayken bir tuşa basıldığında ve aşağı konumda olduğunda gerçekleşir. |
| KeyPress Olayı[InkPicture Denetimi] | InkPicture denetimi odaktayken bir tuşa basıldığında gerçekleşir. |
| KeyUp Olayı [InkPicture Denetimi] | InkPicture denetimi odaktayken bir anahtar serbest bırakıldığında gerçekleşir. |
| MouseDown Olayı [InkPicture Denetimi] | Fare işaretçisi InkPicture denetiminin üzerinde olduğunda ve bir fare düğmesine basıldığında gerçekleşir. |
| MouseEnter | Fare işaretçisi InkPicture denetimine girdiğinde gerçekleşir. |
| MouseHover | Fare işaretçisi InkPicture denetiminin üzerine geldiğinde gerçekleşir. |
| MouseLeave | Fare işaretçisi InkPicture denetiminden ayrıldığında gerçekleşir. |
| MouseMove Olayı [InkPicture Denetimi] | Fare işaretçisi InkPicture denetiminin üzerine taşındığında gerçekleşir. |
| MouseUp Olayı [InkPicture Denetimi] | Fare işaretçisi InkPicture denetiminin üzerinde olduğunda ve fare düğmesi serbest bırakıldığında gerçekleşir. |
| MouseWheel | InkPicture denetimi odaktayken fare tekerleği hareket ettiğinde gerçekleşir. |
| NewInAirPackets Olay | Bir hava içi paket görüldüğünde gerçekleşir. |
| NewPackets Olay | InkPicture denetimi bir paket aldığında gerçekleşir. |
| Boyalı | InkPicture denetimi kendisini yeniden çizmeyi tamamladığında gerçekleşir. |
| Boyama | InkPicture denetimi kendisini yeniden çizmeden önce gerçekleşir. |
| Yeniden Boyutlandırma | InkPicture denetimi yeniden boyutlandırıldığında gerçekleşir. |
| SelectionChanged | InkPicture denetimindeki metin seçimi değiştiğinde, örneğin kullanıcı arabiriminde yapılan değişiklikler, kesme ve yapıştırma yordamları veya Seçimi özelliğinde gerçekleşir. |
| SelectionChanging | InkPicture denetimindeki metin seçimi, kullanıcı arabiriminde yapılan değişiklikler, kesme ve yapıştırma yordamları veya Seçimi özelliği gibi değişmek üzere olduğunda gerçekleşir. |
| SelectionMoved | Geçerli seçimin konumu değiştiğinde (kullanıcı arabiriminde yapılan değişiklikler, kesme ve yapıştırma yordamları veya Seçimi özelliği gibi) gerçekleşir. |
| SelectionMoving Olayı [InkPicture Denetimi] | Geçerli seçimin konumu, örneğin kullanıcı arabiriminde yapılan değişiklikler, kesme ve yapıştırma yordamları veya Seçimi özelliğinde değişiklik yapmak üzere olduğunda gerçekleşir. |
| SelectionResized | Geçerli seçimin boyutu değiştiğinde ( kullanıcı arabiriminde yapılan değişiklikler, kesme ve yapıştırma yordamları veya Seçimi özelliği gibi) gerçekleşir. |
| SelectionResizing | Geçerli seçimin boyutu, kullanıcı arabiriminde yapılan değişiklikler, kesme ve yapıştırma yordamları veya Seçimi özelliği gibi değişmek üzere olduğunda gerçekleşir. |
| SizeChanged | InkPicture denetimi, özellikle Width veya Height özellik değeri değiştikten sonra yeniden boyutlandırıldıktan sonra gerçekleşir. |
| SizeModeChanged | InkPicture denetiminin SizeMode özelliği değiştirildikten sonra gerçekleşir. |
| StyleChanged | Uygulanmadı. |
| Vuruş | Kullanıcı herhangi bir tablette yeni bir vuruş çizdiğinde gerçekleşir. |
| StrokesDeleted |
IInkStrokeDisp nesneleri Ink özelliğinden silindikten sonra gerçekleşir. |
| StrokesDeleting |
IInkStrokeDisp nesneleri Ink özelliğinden silinmeden önce gerçekleşir. |
| SystemColorsChanged | Sistem renkleri değiştikten sonra gerçekleşir. |
| SystemGesture | Sistem hareketi tanındığında gerçekleşir. |
| TabletAdded Event | Sisteme bir tablet eklendiğinde gerçekleşir. |
| TabletRemoved Olay | Bir tablet sistemden kaldırıldığında gerçekleşir. |
| Yöntem | Açıklama |
|---|---|
| GetEventInterest Yöntemi | InkPicture denetiminin belirli bir olayla ilgilenip ilgilenmediğini gösteren bir değer döndürür. |
| GetGestureStatus | InkPicture denetiminin belirli bir uygulama hareketiyle ilgilenip ilgilenmediğini gösteren bir değer döndürür. |
| GetWindowInputRectangle Yöntemi | İçinde mürekkep çizilen pencere dikdörtgenini piksel cinsinden döndürür. |
| HitTestSelection |
SelectionHitResult numaralandırmasının bir üyesini döndürür. Bu, bir isabet testi sırasında seçimin hangi bölümüne (varsa) isabet alındığını belirtir. |
| SetAllTabletsMode Yöntemi | InkPicture denetiminin, Tablet PC'ye bağlı herhangi bir tabletten mürekkep toplamasını sağlar. |
| SetEventInterest Yöntemi | InkPicture denetiminin belirli bir olayla ilgilenip ilgilenmediğini gösteren bir değer ayarlar. |
| SetFocus | Odağı InkPicture denetimine taşır. |
| SetGestureStatus Yöntemi | Belirtilen uygulama hareketinde InkPicture nesnesinin ilgisini ayarlar. |
| SetSingleTabletIntegratedMode Yöntemi | InkPicture denetimini, Tablet PC'ye bağlı tek bir tabletten mürekkep toplamak için ayarlar. Diğer tabletlerden gelen mürekkep yoksayılır. |
| SetWindowInputRectangle Yöntemi | İçinde mürekkep çizilen pencere koordinatlarında ayarlanacağı pencere dikdörtgenini belirtir. |
| ShowWhatsThis | 32 bit Microsoft Windows işletim sistemlerinde Yardım tarafından sağlanan "Bu Nedir" açılan penceresini kullanarak bir Yardım dosyasında seçili konuyu görüntüler (yalnızca tasarım zamanı). |
| ZOrder | Denetimi z düzeninin önüne veya arkasına grafik düzeyine yerleştirir (yalnızca tasarım zamanı). |
| Mülk | Açıklama |
|---|---|
| AutoRedraw Özelliği | Pencere geçersiz kılındığında InkPicture denetiminin yeniden boyanıp boyanmayacağını belirten bir değer alır veya ayarlar (InkPicture denetimiyle ilişkilendirilmiş InkDisp nesnesinin, InkPicture ile ilişkilendirilmiş pencere bir WM_PAINT iletisi aldığında otomatik olarak yeniden çizilip çizilmez). |
| BackColor | InkPicture denetiminin arka plan rengini alır veya ayarlar. Varsayılan arka plan rengi, genellikle beyaz olan sistem penceresi arka plan rengidir. |
| CollectingInk Özelliği | InkPicture denetiminin mürekkep toplayıp toplamadığını belirten değeri alır (yalnızca çalışma zamanı). |
| CollectionMode | Kullanıcı yazarken mürekkep, hareket veya mürekkep ve hareketlerin tanınıp tanınmayacağını belirleyen koleksiyon modunu alır veya ayarlar. |
| İmleçler Özelliği | InkPicture denetiminin mürekkep oluşturma bölgesinde kullanılabilecek IInkCursors koleksiyonunu alır. |
| CustomStrokes | Mürekkeple kalıcı hale getirmek için IInkCustomStrokes koleksiyonunu alır (yalnızca tasarım zamanı). |
| DefaultDrawingAttributes Özelliği | Mürekkep çizerken ve görüntülerken kullanılacak varsayılan InkDrawingAttributes koleksiyonunu alır veya ayarlar (yalnızca çalışma zamanı). |
| DesiredPacketDescription Özelliği | InkPicture denetiminin paket açıklamasını alır veya ayarlar (yalnızca çalışma zamanı). |
| DynamicRendering Özelliği | InkPicture denetiminin toplandığı şekilde mürekkepleri dinamik olarak işleyip işlemediğini belirten değeri alır veya ayarlar. |
| EditingMode | InkPicture denetiminin mürekkep modunda mı, silme modunda mı yoksa seçme/düzenleme modunda mı olduğunu belirten bir değer alır veya ayarlar. |
| Etkin | InkPicture denetiminin kullanıcı tarafından oluşturulan olaylara yanıt verip veremeyeceğini belirleyen bir değer alır veya ayarlar. Not: Bu özellik InkEnabled özelliğine eşdeğerdir. |
| EraserMode | Mürekkebinin vuruşla mı yoksa noktayla mı silindiğini belirten değeri alır veya ayarlar. |
| EraserWidth | Silgi kalem ucunun genişliğini belirten değeri alır veya ayarlar. |
| hWnd | InkPicture denetiminin bağlı olduğu pencere tutamacını alır. (yalnızca çalışma zamanı) |
| mürekkep | InkPicture denetimiyle ilişkili InkDisp nesnesini alır veya ayarlar (yalnızca çalışma zamanı). |
| InkEnabled | InkPicture denetiminin kalem girişi (havadan paketler, aralık olaylarında imleç vb.) toplayıp toplamadığını belirten bir değer alır veya ayarlar. |
| MarginX Özelliği | Ekran koordinatlarında pencere dikdörtgeninin etrafındaki x ekseni kenar boşluğunu alır veya ayarlar. |
| MarginY Özelliği | Ekran koordinatlarında pencere dikdörtgeninin etrafındaki y ekseni kenar boşluğunu alır veya ayarlar. |
| MouseIcon Özelliği | Geçerli özel fare simgesini alır veya ayarlar. |
| MousePointer Özelliği | Fare InkPicture denetiminin belirli bir bölümünün üzerindeyken görüntülenen fare işaretçisi türünü gösteren bir değer alır veya ayarlar. |
| resim | InkPicture denetiminde görüntülenecek grafik dosyasını alır. |
| oluşturucu özelliği | InkPicture denetiminde mürekkep çizmek için kullanılan InkRenderer nesnesini alır veya ayarlar (yalnızca çalışma zamanı). |
| seçim |
InkStrokes koleksiyonunu InkPicture denetiminde seçili durumda alır (yalnızca çalışma zamanı). |
| SizeMode | Denetimin görüntü yerleştirme ve boyutlandırmayı nasıl işlediğini alır veya ayarlar. |
| SupportHighContrastInk Özelliği | Sistem Yüksek Karşıtlık modundayken milenk'in tek bir renk olarak işlenip işlenmediğini belirten bir değer alır. Color = COLOR_WINDOWTEXT (GetSystemMetrics çağrısından). |
| SupportHighContrastSelectionUI | Sistem Yüksek Karşıtlık modundayken tüm seçim kullanıcı arabirimlerinin (seçim sınırlayıcı kutusu ve seçim tutamaçları) yüksek karşıtlıkta çizilip çizildiğini belirten bir değer alır veya ayarlar. |
| Tablet Özelliği | InkPicture denetiminin giriş toplamak için kullandığı IInkTablet nesnesini alır. |
Açıklamalar
InkPicture denetiminin çalışma zamanı kullanıcı arabirimi, opak mürekkep içeren opak arka plana (tek renk, resim arka planı veya her ikisi birden) sahip bir penceredir.
Microsoft Windows 2000, Windows Server 2003, Windows XP Tablet PC Edition dışındaki herhangi bir Windows XP sürümü ve Windows Vista'nın herhangi bir sürümünde mürekkep işlemek için InkPicture denetimini kullanabilirsiniz. Ancak, mürekkep girişi yapabilir, hareketleri kabul edebilir veya el yazısını yalnızca aşağıdaki koşullarda tanıyabilirsiniz:
- Windows Vista veya XP Tablet PC Edition 2005 yüklüyse mürekkep girişi yapılabilir ve tanınabilir.
- Hareketler de tanınabilir.
- Tanıyıcılar mevcut olduğu sürece el yazısı Windows'un eski sürümlerini çalıştıran makinelerden kaynaklanıyorsa el yazısı metin olarak tanınabilir.
Windows XP Tablet PC Edition 2005 dışındaki herhangi bir Windows XP sürümü olan Windows 2000, Windows Server 2003 kullanıyorsanız, InkPicture denetiminin ortam özelliklerine değer atayabilir, sonra da diğer uygulamalara mürekkep kopyalayıp yapıştırabilirsiniz. Ancak InkEnabled özelliğinin değeri her zaman FALSE olacaktır.
Kalıcı InkDisp nesneleri, Windows Vista ve XP'nin tüm sürümlerinde ve yalnızca Windows XP Tablet PC Edition Yazılım Geliştirme Seti'nin (SDK) yüklü olduğu sistemlerde yüklenebilir ve görüntülenebilir. InkDisp nesneleri yalnızca Windows Vista veya Windows XP Tablet PC Edition 2005 yüklüyse metne dönüştürülebilir (tanınır).
Bu denetimdeki işlemler başarılı olmazsa, yasal bir HRESULT döndürülür. Hata koşulları oluşursa, döndürülen HRESULT değerini hataya karşı denetleyin.
Mürekkep denetimleri hakkında daha fazla bilgi için bkz. mürekkep .
Belirli olayları hangi iş parçacıklarının tetiklediği hakkında bilgi için bkz. Bir OlayınTetikleyebileceği İş Parçacıkları.
Uygulamanızın performansını geliştirmek için artık gerekli olmadığında inkPicture denetimini el ile atın.
Not
InkPicture denetimi, saydam olarak ayarlanmış GroupBox gibi başka bir denetimle katmanlandığında, InkPicture mürekkep toplamaz. InkPicture, Z düzeninde en üstteki denetim veya GroupBoxalt öğesi olmalıdır.
COM Uygulaması
Bu nesne IInkPicture COM arabirimini uygular.