Açılır Liste¶

Açılır Liste widget'ı, kullanıcıların önceden tanımlanmış bir listeden tek bir seçenek belirlemesini sağlar. Bu liste statik olarak veya veri kaynakları kullanılarak dinamik biçimde doldurulabilir (ayrıntılar için bkz. Veri Kaynakları ). Widget, uzun listelerde seçimi kolaylaştırmak için yerleşik bir arama mekanizması içerir. Seçim, özelliği kullanılarak veri modeline otomatik olarak eşlenir: Seçim Eşlemesi .

Elle Giriş¶

Eğer AllowNew özelliği şu değere ayarlanırsa truekullanıcılar önceden tanımlanmış listede bulunmayan değerleri girebilir. Aksi takdirde yalnızca mevcut seçenekler seçilebilir.

XML Alanları¶

Bağlama ve Seçim¶

• XPath Form verisi bağlamını seçer. ValueXPath Seçilen öğedeki, form verisine yazılacak alanı seçer. CaptionXPath Kullanıcıya gösterilen metni isteğe bağlı olarak bu değerin yanında saklar.
• MappingXPath Ne zaman kopyalanacağını belirleyerek ek öğe alanlarını seçer MapSelection ise True. Bir öğenin seçilmesinin ilişkili form alanlarını da doldurması gerektiğinde kullanın.

Seçenek Kaynağı¶

• DataSources Kullanılabilir seçenekleri tanımlar. Statik bir ListItemDataSource görünür metin için TextFormat ve saklanan değer için kullanır ValueFormat ; diğer kaynaklar aynı biçimdeki verileri bir sorgudan veya hizmetten alabilir.
• MonitoredXPaths Değiştiklerinde seçenekleri yenileyen veri yollarını listeler. Bağımlı açılır listeler için kullanın. CacheDataSources Geçerli kaynak sonucunun yenilemeler arasında yeniden kullanılıp kullanılmayacağını belirler.

Girdi Davranışı¶

• AutoSelectValue Geçerli değer boş olduğunda ilk geçerli seçeneği belirler. AllowNew Kaynakta bulunmayan bir değere izin verir. MapSelection İşlemeyi MappingXPath etkinleştirir.
• Size Genişliği belirler. RequiredForGroup Bir düğme aynı grubu doğruladığında zorunlu alan doğrulamasını uygular. Hints Yardım metni sağlar ve Rules biçimlendirme veya doğrulama kurallarını içerir.

Otomatik Değer Seçimi¶

Varsayılan olarak, ilgili veri modeli öğesi boşsa widget yüklendiğinde kullanılabilir ilk öğe seçilir. Bu davranış, özelliği AutoSelectValue şu değere falseayarlanarak devre dışı bırakılabilir. AutoSelectValue şu değere falseayarlandığında önceden hiçbir öğe seçilmez; değer zorunluysa kullanıcının seçim yapması gerekir.

Seçim Eşlemesi¶

Seçilen öğenin değeri varsayılan olarak ValueXPath öğesine, görüntüleme metni ise CaptionXPath öğesine eşlenir.

Ek öğe özelliklerini diğer veri modeli öğeleriyle eşlemek için MapSelection özelliğini şu değere trueayarlayın. Eşleme kök yolu varsayılan olarak widget'ın XPath'idir ancak MappingXPath özelliği kullanılarak özelleştirilebilir.

Bir örnek için bkz. Seçim Eşleme Örneği .

Veri Kaynağı Önbelleğe Alma¶

Performansı artırmak için bileşen, veri kaynaklarını varsayılan olarak önbelleğe alır. Bu önbelleğe alma, özelliği CacheDataSources şu değere ayarlayarak falsedevre dışı bırakılabilir. Önbelleğe almayı devre dışı bırakmak, bileşen her görüntülendiğinde veri kaynaklarının yeniden yüklenmesine neden olur.

Basit Örnek¶

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

<DropDown XPath="ManualEntry" RequiredForGroup="" CacheDataSources="True" Size="Medium" AutoSelectValue="False" AllowNew="False" MapSelection="False">
    <ValueXPath><![CDATA[Id]]></ValueXPath>
    <CaptionXPath><![CDATA[Name]]></CaptionXPath>
    <MappingXPath><![CDATA[]]></MappingXPath>
    <DataSources>
        <ListItemDataSource TextFormat="{{Text}}" ValueFormat="{{Value}}" Enabled="true">
            <Mappings/>
            <Items>
                <Item>
                    <Text><![CDATA[Option 1]]></Text>
                    <Value><![CDATA[Option1]]></Value>
                </Item>
                <Item>
                    <Text><![CDATA[Option 2]]></Text>
                    <Value><![CDATA[Option2]]></Value>
                </Item>
            </Items>
        </ListItemDataSource>
    </DataSources>
    <MonitoredXPaths/>
    <Hints><![CDATA[]]></Hints>
    <Rules />
</DropDown>

İlgili Sayfalar¶

• Formlar
• Form Widget'ları
• Veri Kaynakları

Seçim Eşleme Örneği¶

Aşağıdaki veri modelini inceleyin:

1
2
3
4
5

<ManualEntry>
    <Id></Id>
    <Name></Name>
    <MappedField></MappedField>
</ManualEntry>

Aşağıdaki örnekte, seçilen öğenin MappedField değerinin seçim yapıldığında veri modelindeki MappedField öğesine otomatik olarak nasıl kopyalandığı gösterilmektedir:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

<DropDown XPath="ManualEntry" RequiredForGroup="" CacheDataSources="True" Size="Medium" AutoSelectValue="False" AllowNew="False" MapSelection="True">
    <ValueXPath><![CDATA[Id]]></ValueXPath>
    <CaptionXPath><![CDATA[Name]]></CaptionXPath>
    <MappingXPath><![CDATA[]]></MappingXPath>
    <DataSources>
        <ListItemDataSource TextFormat="{{Text}}" ValueFormat="{{Value}}" Enabled="true">
            <Mappings/>
            <Items>
                <Item>
                    <Text><![CDATA[Option 1]]></Text>
                    <Value><![CDATA[Option1]]></Value>
                    <MappedField>X</MappedField>
                </Item>
                <Item>
                    <Text><![CDATA[Option 2]]></Text>
                    <Value><![CDATA[Option2]]></Value>
                    <MappedField>Y</MappedField>
                </Item>
            </Items>
        </ListItemDataSource>
    </DataSources>
    <MonitoredXPaths/>
    <Hints><![CDATA[]]></Hints>
    <Rules />
</DropDown>