Açılır Liste¶

Açılır Liste bileşeni, 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ı ). Bileşen, uzun listelerde seçimi kolaylaştırmak için yerleşik bir arama mekanizması içerir. Seçim, otomatik olarak veri modeline eşlenir; bunun için Seçim Eşleme özelliği kullanılır.

Elle Giriş¶

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

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 İsteğe bağlı olarak, kullanıcıya gösterilen metni bu değerle birlikte saklar.
• MappingXPath şu durumda kopyalanacak ek öğe alanlarını seçer: MapSelection değeri Trueolduğunda. Bir öğeyi seçmenin 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 değerini, saklanan değer içinse ValueFormat değerini kullanır; diğer kaynaklar aynı yapıyı 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 yenilemeler arasında geçerli kaynak sonucunun yeniden kullanılıp kullanılmayacağını denetler.

Girdi Davranışı¶

• AutoSelectValue Geçerli değer boş olduğunda ilk geçerli seçeneği belirler. AllowNew Kaynak tarafından döndürülmeyen bir değere izin verir. MapSelection işlemeyi MappingXPath etkinleştirir.
• Size Genişliği denetler. RequiredForGroup Bir düğme aynı grubu doğruladığında zorunlu alan doğrulamasını uygular. Hints Yardım metnini 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 bileşen yüklendiğinde kullanılabilir ilk öğe seçilir. Bu davranış, şu özelliğin AutoSelectValue değerine falseayarlanmasıyla devre dışı bırakılabilir. AutoSelectValue değerine ayarlandığında falseönceden hiçbir öğe seçilmez; bir değer zorunluysa kullanıcının seçim yapması gerekir.

Seçim Eşleme¶

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

Ek öğe özelliklerini diğer veri modeli öğelerine eşlemek için MapSelection özelliğini trueolarak ayarlayın. Eşleme kök yolu varsayılan olarak bileşenin XPath değeridir, ancak MappingXPath özelliği kullanılarak özelleştirilebilir.

Bir örnek için Seçim Eşleme Örneği bölümüne bakın.

Veri Kaynağı Önbelleğe Alma¶

Performansı artırmak için widget, veri kaynaklarını varsayılan olarak önbelleğe alır. Bu önbelleğe alma, CacheDataSources özelliği şu değere ayarlanarak devre dışı bırakılabilir: false. Önbelleğe almayı devre dışı bırakmak, widget 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 ele alalım:

1
2
3
4
5

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

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

 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>