Aracılığıyla paylaş

SelectionTree Denetimi

  • Makale

Bu denetim, kullanıcının Özellik tablosunda listelenen özelliklerin seçim durumunu değiştirmesine olanak tanır. Denetim, kullanıcının birGözat iletişim kutusu tarafından ayarlayabildiği bir dize değerli özelliğiyle ilişkilendirilir. Denetimi tablosununÖzellik sütununa özelliğin adını girerek denetimi bir özellikle ilişkilendirebilirsiniz.

SelectionTree denetimi, Windows XP veya önceki işletim sistemlerinde aşağıdaki Denetim Olayları otomatik olarak yayımlar. Seçili öğe bir düğümden diğerine değiştirildiğinde SelectionTree denetimi bu olayları yayımlar. Seçim ağacının düğümleri yoksa, denetim bu olayları yayımlar ve olaya abone olan denetimlerin içeriğini siler. Bu ControlEvent'lerin ControlEvent tablosunda listelenmeleri gerekmez.

Denetim olayı Açıklama
SelectionAction vurgulanan öğeyi açıklayan UIText tablosundan bir dize yayımlar.
SelectionBrowse Vurgulanan öğenin yolunu değiştirmek için kullanılan bir Gözat iletişim kutusu oluşturur.
SelectionDescription vurgulanan öğeyi açıklayan Özellik tablosundan bir dize yayımlar.
SelectionNoItems Açıklayıcı metni siler veya eski bir öğenin düğmelerini devre dışı bırakır.
SelectionPath Vurgulanan öğenin yolunu yayımlar.
SelectionPathOn Seçili durumdaki özellikle ilişkilendirilmiş bir seçim yolu olup olmadığını yayımlar.
Size Vurgulanan öğenin boyutunu yayımlar.

 

Windows Server 2003 sistemlerinden başlayarak SelectionTree denetimleri yukarıdaki tabloda yer alan tüm olayları yayımlar ve buna ek olarak bir DoAction ControlEvent veya SetProperty ControlEventyayımlar. DoAction veya SetProperty ControlEvents yayımlamak için kayıtların ControlEvent tablosuna eklenmesi gerekir.

Denetim olayı Açıklama
DoAction Yükleyiciye özel bir eylem yürütmesi için bildirir.
SetProperty Bir özelliği yeni bir değere ayarlar.

 

Windows Installer 3.0 sürümünden başlayarak SelectionTree denetimleri, ControlEvent tablosundalistelenen özel eylemleri çalıştıran bir olay yayımlar. SelectionTree denetimi, denetimde özellik seçimi değiştiğinde veya geçerli özellik için farklı bir seçim durumu seçildiğinde bu olayı yayımlar. Özel eylemler, olay her yayımlandığında çalışır. SelectionTree denetimi, aşağıdaki özelliklerin değerlerini ayarlayarak özel eyleme bilgi gönderir. SelectionTree denetimi kapatıldığında tüm bu özellikler temizlenir.

Windows Installer 2.0: Desteklenmiyor. SelectionTree denetimi olayı yayımlamaz ve aşağıdaki özellikleri ayarlamaz.

Mülk Açıklama
MsiSelectionTreeSelectedFeature Seçilen özelliğin adı, Özellik tablosunun Özellik alanında.
MsiSelectionTreeSelectedAction Seçili özelliğin yükleme eylem durumu. Değer INSTALLSTATE_ABSENT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE veya INSTALLSTATE_ADVERTISED olabilir.
MsiSelectonTreeChildrenCount Doğrudan alt düğüm sayısı.
MsiSelectionTreeInstallingChildrenCount INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE veya INSTALLSTATE_ADVERTISED doğrudan alt düğümlerin sayısı.
MsiSelectionTreeSelectedCost Seçilen özelliği 512 baytlık birimler halinde yükleme maliyeti.
MsiSelectionTreeChildrenCost Tüm alt özellikleri 512 baytlık birimler halinde yükleme maliyeti.
MsiSelectionTreeSelectedPath Seçili özelliğin yüklendiği yol. Yalnızca özellik INSTALLSTATE_LOCAL olarak yükleniyorsa tanımlanır.

 

Not

Denetimi tablosu Metin alanının içeriği SelectionTree denetimi tarafından hiçbir zaman görüntülenmez. Bunun yerine, bu alan denetim tarafından görüntülenecek metin stilini belirtir ve ekran gözden geçirme yardımcı programları tarafından kullanılan denetimin açıklamasını içerir. Bir metin dizesinin yazı tipi ve yazı tipi stilini ayarlamak için görüntülenen karakter dizesine {\style} veya {&stili} ön ekini ekleyin. Burada stil, TextStyle tablosununTextStyle sütununda listelenen bir tanımlayıcıdır. Bunlardan hiçbiri yoksa, ancak DefaultUIFont özelliği geçerli bir metin stili olarak tanımlanırsa, bu yazı tipi kullanılır. Bunu izleyen bilgiler, denetimin açıklaması olarak ekran gözden geçirme yardımcı programları tarafından okunur. Bkz. Erişilebilirlik .

 

Denetim Öznitelikleri

Bu denetimle aşağıdaki öznitelikleri kullanabilirsiniz. Bir olayı kullanarak özniteliğin değerini değiştirmek için, denetimi EventMapping tablosundaki bir ControlEvent'e abone olun ve özniteliğin tanımlayıcısını Öznitelik sütununda listeleyin. Olay sütununa ControlEvent tanımlayıcısını girin.

Öznitelik tanımlayıcısı Onaltılık bit Açıklama
IndirectPropertyName Denetimle ilişkili dolaylı özelliğin adı. Dolaylı öznitelik biti ayarlanırsa, denetim bu ada sahip özelliğin değerini görüntüler veya değiştirir. Dolaylı öznitelik biti ayarlanırsa, bu ad aynı zamanda Denetimi tablosunun Özellik sütununda listelenen özelliğin değeridir.
Konum İletişim kutusundaki denetimin konumu. Denetimin sol köşesinin genişliğini, yüksekliğini ve koordinatlarını Denetim tablosunun Width, Height, X ve Y sütunlarınagirin. Uzunluk ve uzaklık için yükleyici birimlerini kullanın.
PropertyName Bu denetimle ilişkili özelliğin adı. Dolaylı öznitelik biti ayarlanmadıysa, denetim bu ada sahip özelliğin değerini görüntüler veya değiştirir. Bu öznitelik, Denetimi tablosunun Özellik sütununda belirtilir.
PropertyValue Bu denetim tarafından görüntülenen veya değiştirilen özelliğin geçerli değeri. Dolaylı öznitelik biti ayarlanmadıysa, bu PropertyName değeridir. Dolaylı öznitelik biti ayarlanırsa, bu IndirectPropertyName değeridir. Öznitelik değişirse, denetim yeni değeri yansıtır.
metin Denetimi tablosunun Metin sütununa girilen metne göre ekran okuyuculardaki metnigörüntüler. Bkz. Erişilebilirlik .
görünür 0x00000000 0x00000001
 Gizli denetim. Görünür denetim.
Denetimin oluşturulması sırasında görünür veya gizli olmasını sağlamak için bu biti Denetimi tablosundaki Öznitelikler sütununun bit sözcüğüne ekleyin.
Ayrıca, ControlCondition tablosunu kullanarak bir denetimi gizleyebilir veya gösterebilirsiniz.
Etkin 0x00000000 0x00000002
 Denetim devre dışı durumda. Etkin durumdaki denetim.
Oluşturmada denetimi etkinleştirmek için bu biti Denetimi Öznitelikler sütunundaki bit sözcüğüne ekleyin.
ControlCondition tablosunukullanarak da denetimi etkinleştirebilir veya devre dışı bırakabilirsiniz.
Batık 0x00000000 0x00000004
 Varsayılan görsel stilini görüntüler. Denetimi batık, 3B bir görünümle görüntüler.
Bu bitleri Denetimi tablosunun Öznitelikler sütunundaki bit sözcüğüne ekleyin.
Dolaylı 0x00000000 0x00000008
 Denetim, Denetim tablosunun Özellik sütunundaki özelliğinin değerinigörüntüler veya değiştirir. Denetim, Control tablosunun Özellik sütununda Tanımlayıcı'nın listelendiği özelliğin değerini görüntüler veya değiştirir.
Bu denetimle ilişkili özelliğe dolaylı olarak başvurulup başvurulmadığını belirler.
RTLRO 0x00000000 0x00000020
 Denetimdeki metin soldan sağa okuma sırasına göre görüntülenir. Denetimdeki metin sağdan sola okuma sırasına göre görüntülenir.
Sağ Hizalı 0x00000000 0x00000040
 Denetimdeki metin sola hizalanır. Denetimdeki metin sağa hizalanır.
LeftScroll 0x00000000 0x00000080
 Kaydırma çubuğu denetimin sağ tarafında bulunur. Kaydırma çubuğu denetimin sol tarafında bulunur.
BiDi 0x000000E0 RTLRO, RightAlignedve LeftScroll özniteliklerinin bir bileşimi için bu değeri ayarlayın.

 

Açıklamalar

Bu denetim, CreateWindowEx işlevi kullanılarak WC_TREEVIEW sınıfından oluşturulabilir. WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOPve WS_GROUP stilleri vardır.

Seçim ağacı yalnızca CostInitialize eylemi ve CostFinalize eylemi çağrıldığında doldurulur.

UIText tablo aşağıdaki dize bu denetimle ilgilidir.

Terim Açıklama
AbsentPath
 Yok durumundaki bir öğe için görüntülenen yol.

 

Seçilen alt öğelerin sayısını ve vurgulanan öğeyle ilişkili boyutu görüntülemek için aşağıdaki altı dize kullanılır:

  • SelChildCostPos
  • SelChildCostNeg
  • SelParentCostPosPos
  • SelParentCostPosNeg
  • SelParentCostNegPos
  • SelParentCostNegNeg

Açılan menüde bir öğe için kullanılabilir seçim seçeneklerini görüntülemek için aşağıdaki dizeler kullanılır:

  • MenuAbsent
  • MenuLocal
  • MenuCD
  • MenuNetwork
  • MenuAllLocal
  • MenuAllCD
  • MenuAllNetwork

SelectionDescription ControlEvent içindeki mevcut seçimi açıklamak için aşağıdaki dizeler kullanılır.

  • SelAbsentAbsent
  • SelAbsentLocal
  • SelAbsentCD
  • SelAbsentNetwork
  • SelLocalAbsent
  • SelLocalLocal
  • SelLocalCD
  • SelLocalNetwork
  • SelCDAbsent
  • SelNetworkAbsent
  • SelCDLocal
  • SelNetworkLocal
  • SelCDCD
  • SelNetworkNetwork

Dosyanın boyutunu biçimlendirmek için aşağıdaki dört yerelleştirilmiş dize kullanılır:

  • Bayt
  • KB
  • MB
  • GB