RadioButtonGroup Control
A RadioButtonGroup vezérlő a választógombok egy csoportja. Lehetővé teszi a felhasználó számára, hogy egy tulajdonsághoz sztringet vagy egész számot válasszon ki egy előre meghatározott értéklistából. Ezt a vezérlőelemet társíthatja egy tulajdonsággal úgy, hogy a tulajdonság nevét beírja a Vezérlőelem táblaTulajdonság oszlopába. Adja meg a kijelölés lehetséges értékeit a RadioButton táblaÉrték oszlopában. Vegye figyelembe, hogy a megjelenített sztring nem feltétlenül ugyanaz, mint a felhasználó által választott érték.
Minden RadioButtonGroup vezérlőelem egy tulajdonsághoz van társítva. A tulajdonság alapértelmezett értékét inicializálni kell a Tulajdonság tábla. A RadioButton táblamegadott radiobuttoncsoporton belül lehet egy választógomb, amelynek értéke az Érték mezőben megegyezik a tulajdonság alapértelmezett értékével. Ez a RadioButtonGroup vezérlő alapértelmezett gombja. Az Alapértelmezett gomb kezdetben a vezérlőelemben kijelöltként jelenik meg.
Vegye figyelembe, hogy a párbeszédpanelek fókusza nem helyezhető át a RadioButtonGroup vezérlőelemre, amíg a csoport egyik gombja ki nem van jelölve. Ha a fókuszt erre a gombcsoportra szeretné helyezni, adja meg az egyik gombot a csoport alapértelmezett gombjaként.
A RadioButtonGroup vezérlők csak a tulajdonságértékeket állítják be, és nem használhatók ControlEventküldésére.
Az implementáció az egész csoportot egyetlen vezérlőként kezeli, ezért nem lehet elrejteni vagy letiltani az egyes gombokat a csoportban. Hasonlóképpen az összes gombnak azonos stílusúnak kell lennie, vagyis vagy mindegyiknek van szövege, vagy mindegyiknek bitképe van (vagy más hasonló funkciók). A gombok helye a csoporthoz viszonyítva van megszerkesztett állapotban. Így a teljes csoport áthelyezhető úgy, hogy csak a csoport koordinátáit módosítja az egyes gombok módosítása nélkül. A létrehozáskor a vezérlő ellenőrzi, hogy az egyes gombok nem nyúlnak-e túl a csoport határain.
Vezérlőattribútumok
Ezzel a vezérlővel az alábbi attribútumokat használhatja. Ha egy attribútum értékét esemény használatával szeretné módosítani, iratkozzon fel egy ControlEvent vezérlőre az EventMapping táblában, és sorolja fel az attribútum azonosítóját az Attribútum oszlopban. Adja meg a ControlEvent azonosítóját az Esemény oszlopban.
| Attribútumazonosító | Hexadecimális bit | Leírás |
|---|---|---|
| IndirectPropertyName | Ez a vezérlőelemhez társított közvetett tulajdonság neve. Ha a Közvetett attribútum bit be van állítva, a vezérlő megjeleníti vagy módosítja az ilyen nevű tulajdonság értékét. Ha a Közvetett attribútum bit be van állítva, akkor ez a név a Control táblaTulajdonság oszlopában felsorolt tulajdonság értéke is. | |
| pozíció | A vezérlő helye a párbeszédpanelen. Adja meg a vezérlőelem bal oldali sarkának szélességét, magasságát és koordinátáit a Control táblaSzélesség, Magasság, X és Y oszlopába. Használjon telepítőegységeket a hosszhoz és a távolsághoz. |
|
| PropertyName | Ez a vezérlőelemhez társított tulajdonság neve. Ha a Közvetett attribútum bit nincs beállítva, a vezérlő megjeleníti vagy módosítja az ilyen nevű tulajdonság értékét. Ez az attribútum a Control táblaTulajdonság oszlopában van megadva. | |
| PropertyValue | A vezérlőelem által megjelenített vagy módosított tulajdonság aktuális értéke. Ha a Közvetett attribútum bit nincs beállítva, akkor ez a PropertyName értéke. Ha a Közvetett attribútum bit be van állítva, akkor ez az IndirectPropertyName értéke. Ha az attribútum megváltozik, a vezérlő az új értéket tükrözi. | |
| Szöveg | Ez a vezérlőattribútum megadhatja a vezérlő által megjelenített szöveget, a bináris táblázatban tárolt képet vagy a futtatáskor beállított képet. Szöveg megadásához írja be a szöveges sztringet a Vezérlőelem táblaSzöveg oszlopába. A szöveg betűtípusának és betűstílusának beállításához a megjelenített karakterek sztringjét {\style} vagy {&stílus} előtaggal kell megadni. Ahol a stílus az TextStyle tábla TextStyle oszlopában szereplő azonosító,. Ha egyik sem található, de a DefaultUIFont tulajdonság érvényes szövegstílusként van definiálva, akkor a program ezt a betűtípust fogja használni. Ha a bináris táblában tárolt ikont vagy bitképet szeretne megadni, írja be a kép rekordjának elsődleges kulcsát a Bináris tábla Név oszlopából a vezérlő Vezérlőelem tábla Szöveg oszlopába rekordba. |
|
| Látható | 0x00000000 0x00000001 |
Rejtett vezérlő. Látható vezérlő. Ezt a bitet a Control tábla Attribútumok oszlopának bitszava belefoglalva láthatóvá vagy rejtettsé teheti a vezérlőt a létrehozásakor. A vezérlőelemeket a ControlCondition táblahasználatával is elrejtheti vagy megjelenítheti. |
| Engedélyezett | 0x00000000 0x00000002 |
Vezérlőelem letiltott állapotban. Vezérlőelem engedélyezett állapotban. Vegye fel ezt a bitet a Vezérlőelem Attribútumok oszlopában a vezérlőelem létrehozáskor való engedélyezéséhez. A vezérlőelemeket a ControlCondition táblahasználatával is engedélyezheti vagy letilthatja. |
| elsüllyedt | 0x00000000 0x00000004 |
Megjeleníti az alapértelmezett vizuális stílust. A vezérlőt egy elsüllyedt, térhatású megjelenéssel jeleníti meg. Vegye fel ezeket a biteket a bit szóba a Control tábla Attribútumok oszlopában. |
| közvetett | 0x00000000 0x00000008 |
A vezérlő megjeleníti vagy módosítja a tulajdonság értékét a Control tábla Tulajdonság oszlopában. A vezérlő megjeleníti vagy módosítja annak a tulajdonságnak az értékét, amelynek azonosítója szerepel a Control tábla Tulajdonság oszlopában. Meghatározza, hogy a vezérlőhöz társított tulajdonságra közvetetten hivatkozik-e. |
| egész szám | 0x00000000 0x00000010 |
A vezérlőelemhez társított tulajdonság egy sztringérték. A vezérlőelemhez társított tulajdonság egész szám. Vegye fel ezt a bitet a Control tábla Attribútumok oszlopának bitszavaiba, az attribútum beállításához a vezérlő létrehozásakor. |
| RTLRO | 0x00000000 0x00000020 |
A vezérlőben lévő szöveg balról jobbra olvasási sorrendben jelenik meg. A vezérlőben lévő szöveg jobbról balra olvasási sorrendben jelenik meg. |
| RightAligned | 0x00000000 0x00000040 |
A vezérlőben lévő szöveg balra van igazítva. A vezérlőben lévő szöveg jobbra van igazítva. |
| PushLike | 0x00000000 0x00020000 |
A vezérlő a szokásos megjelenésével van rajzolva. A vezérlőelem BS_PUSHLIKE stílussal rendelkezik, és leküldéses gombként jelenik meg. Vegye fel ezt a bitet a Control tábla Attribútumok oszlopának bitszavaiba, az attribútum beállításához a vezérlő létrehozásakor. |
| Bitmap | 0x00000000 0x00040000 |
A vezérlőelem szövegét a Vezérlőelem táblaSzöveg oszlopában adhatók meg. A vezérlő BS_BITMAP stílussal rendelkezik, a vezérlő szövegét bitképek váltják fel. A Vezérlőtábla Szöveg oszlopa a bináris táblakülső kulcsaként használatos. A bit belefoglalása a bit szóba a Control tábla Attribútumok oszlopában. Ne állítsa be egyszerre az Ikon és a Bitkép stílus bitet. A gomb nem tartalmazhat bitképképet és szöveget is. Egy szöveges sztring betűtípusának és betűstílusának beállításához a megjelenített karakterek sztringjét {\style} vagy {&stílus} előtaggal adhatja meg. Ahol a stílus az TextStyle tábla TextStyle oszlopában szereplő azonosító,. Ha egyik sem található, de a DefaultUIFont tulajdonság érvényes szövegstílusként van definiálva, akkor a program ezt a betűtípust fogja használni. |
| Ikon | 0x00000000 0x00080000 |
A vezérlőelem szövegét a Vezérlőelem táblaSzöveg oszlopában adhatók meg. A vezérlő stílusa BS_ICON, a vezérlő szövegét ikonkép váltja fel. A Vezérlőtábla Szöveg oszlopa a bináris táblakülső kulcsaként használatos. A bit belefoglalása a bit szóba a Control tábla Attribútumok oszlopában. Ne állítsa be egyszerre az ikon- és bitképbiteket. A gomb nem tartalmazhat ikonképet és szöveget is. Egy szöveges sztring betűtípusának és betűstílusának beállításához a megjelenített karakterek sztringjét {\style} vagy {&stílus} előtaggal adhatja meg. Ahol a stílus az TextStyle tábla TextStyle oszlopában szereplő azonosító,. Ha egyik sem található, de a DefaultUIFont tulajdonság érvényes szövegstílusként van definiálva, akkor a program ezt a betűtípust fogja használni. |
| FixedSize | 0x00000000 0x00100000 |
Az ikon képének húzása a vezérlőhöz igazítva. Az ikon képének körülvágása vagy középre igazítása a vezérlőben. Adja meg ezt a bitet a Control tábla Attribútumok oszlopának bitszava. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Betölti az első képet. Betölti az első 16x16-os képet. Betölti az első 32x32-képet. Betölti az első 48x48-képet. Az ikonfájlok különböző méretű képeket tartalmazhatnak ugyanabból az ikonból. Adja meg a megfelelő bitszavat a Control tábla Attribútumok oszlopában Ha ezek a bitek nincsenek beállítva, a telepítő figyelmen kívül hagyja a FixedSize attribútumot, és a rendszerkép a vezérlő téglalapjának megfelelően van kifeszítve. Ha az IconSize bitek és a FixedSize bitek is be vannak állítva, a vezérlőelemnél kisebb kép középre van állítva, és a rendszerkép nagyobb, mint a vezérlőelem, amelyet elfér. |
| HasBorder | nincs beállítva 0x01000000 |
Nincs szegély és nincs szöveg. Szegély és szöveg megjelenítése. A szegély és a szöveg megjelenítéséhez a Vezérlőelem Attribútumok oszlopában adja meg a 16777216 a bitszavat. |
Megjegyzések
Mivel a Windows rajzolja a keretet, a vezérlő ablakának teteje és a látható keret között még akkor is van különbség, ha nincs felirat.
Ez a vezérlő a BUTTON osztályból hozható létre a CreateWindowEx függvénnyel. Ha a HasBorder bit be van állítva, az BS_GROUPBOX stílust tartalmazza, ellenkező esetben a BS_OWNERDRAW stílust.
A RadioButtonGroup vezérlőelem nem fedhet át más vezérlőket, és más vezérlők nem fedik át a RadioButtonGroupot. Ha átfedi ezt a vezérlőt és egy másikat, a vezérlők működése vagy helytelen megjelenítése okozhatja. Ha további leíró szöveget szeretne biztosítani a képernyőolvasó programoknak a RadioButtonGroup vezérlőelemről, kövesse az Extra szöveg hozzáadása a választógombokcímű témakörben található példát.