Általános vezérlési referencia
Ez a szakasz olyan programozási elemekre vonatkozó referenciainformációkat tartalmaz, amelyek több vezérlőre vonatkoznak, nem csak egy adott vezérlőre. A legtöbb vezérlő által támogatott függvények, makrók, üzenetek, értesítések és struktúrák támogatottak. A legtöbb vezérlő például az NM_HOVER-értesítéseket használja az egérkattintások feldolgozásához.
Áttekintés
Téma | Tartalomjegyzék |
---|---|
A gyakori vezérlők | A közös vezérlők a közös vezérlőtár által implementált ablakok, amelyek a Windows operációs rendszer dll-jének részét képezik. |
gyakori vezérlők – gyakori kérdések | Ez a gyakori kérdések választ adnak a gyakori vezérlőkkel kapcsolatos gyakori kérdésekre. |
Funkciók
Téma | Tartalomjegyzék |
---|---|
DoReaderMode | Olvasó mód engedélyezése az ablakban. |
DPA_Clone | Egy dinamikus mutatótömb (DPA) duplikálása. |
DPA_Create | Létrehoz egy DPA-t. |
DPA_CreateEx | Létrehoz egy DPA-t egy megadott méret és halomhely használatával. |
DPA_DeleteAllPtrs | Eltávolítja az összes elemet egy DPA-ból, és ennek megfelelően zsugorítja a DPA-t. |
DPA_DeletePtr | Eltávolít egy elemet egy DPA-ból. A DPA szükség esetén zsugorodik az eltávolított elem elhelyezéséhez. |
DPA_Destroy | Felszabadít egy dinamikus mutatótömböt (DPA). |
DPA_DestroyCallback | Meghívja pfnCB a DPA minden elemére, majd felszabadítja a DPA-t. |
DPA_EnumCallback | Végigfut a dinamikus mutatótömbön (DPA), és meghívja pfnCB minden elemen. |
DPA_GetPtr | Lekéri az elemet egy DPA-ból. |
DPA_GetPtrIndex | Lekéri a DPA-ban talált egyező elem indexét. |
DPA_GetSize | Lekéri a DPA méretét. |
DPA_Grow | A DPA mutatóinak számát módosítja. |
DPA_InsertPtr | Új elemet szúr be egy adott pozícióba egy DPA-ban. Szükség esetén a DPA kibővül az új elem elhelyezéséhez. |
DPA_LoadStream | Betölti a DPA-t egy streamből úgy, hogy meghívja a megadott visszahívási függvényt az egyes elemek beolvasásához. |
DPA_Merge | Két DPA tartalmát egyesíti. |
DPA_SaveStream | A DPA-t egy streambe menti egy fejléc kiírásával, majd meghívja a megadott visszahívási függvényt az egyes elemek írásához. |
DPA_Search | Megkeres egy elemet egy DPA-ban. |
DPA_SetPtr | Érték hozzárendelése egy DPA-beli elemhez. |
DPA_Sort | A dinamikus mutatótömb (DPA) elemeinek rendezése. |
DrawShadowText | Árnyékot tartalmazó szöveget rajzol. |
DrawTextExPrivWrap | Formázott szöveget rajzol a megadott téglalapban. Ez a függvény körbefuttat egy hívást DrawTextEx. |
DrawTextWrap | Formázott szöveget rajzol a megadott téglalapban. A szöveg formázása a megadott módszer szerint (fülek kibontása, karakterek beigazolása, törésvonalak stb.). Ez a függvény körbefuttat egy hívást DrawText. |
DSA_Clone | Egy dinamikus struktúratömb (DSA) duplikálása. |
DSA_Create | Létrehoz egy DSA-t. |
DSA_DeleteAllItems | Törli az összes elemet egy DSA-ból. |
DSA_DeleteItem | Egy elemet töröl egy DSA-ból. |
DSA_Destroy | Felszabadít egy DSA-t. |
DSA_DestroyCallback | Az iterálás egy DSA-n keresztül történik, és minden elemen meghív egy adott visszahívási függvényt. A tömb végére érve a DSA felszabadul. |
DSA_EnumCallback | Iterál a DSA-n keresztül, és meghívja pfnCB minden egyes elemen. |
DSA_GetItem | Lekéri az elemet egy DSA-ból. |
DSA_GetItemPtr | Egy DSA egy elemére mutató mutatót kap. |
DSA_GetSize | Lekéri a DSA méretét. |
DSA_InsertItem | Új elemet szúr be egy DSA-ba. Szükség esetén a DSA kibővül az új elem elhelyezéséhez. |
DSA_SetItem | Beállítja egy elem tartalmát egy DSA-ban. |
DSA_Sort | A DSA elemeinek rendezése. |
ExtTextOutWrap | A jelenleg kijelölt betűtípussal, háttérszínnel és szövegszínnel rajzol szöveget. Megadhat dimenziókat a kivágáshoz, az átlátszatlansághoz vagy mindkettőhöz. Ez a függvény az ExtTextOuthívását tördeli. |
GetEffectiveClientRect | Kiszámítja egy téglalap méretét az ügyfélterületen, amely az összes megadott vezérlőt tartalmazza. |
GetMUILanguage | Lekéri az adott folyamat közös vezérlői által jelenleg használt nyelvet. |
GetTextExtentPoint32Wrap | Kiszámítja a megadott szövegsztring szélességét és magasságát. Ez a függvény körbefuttat egy hívást GetTextExtentPoint. |
InitCommonControls | Regisztrál és inicializál bizonyos gyakori vezérlőablak-osztályokat. Ez a függvény elavult. Az új alkalmazásoknak az InitCommonControlsEx függvényt kell használniuk. |
InitCommonControlsEx | A közös vezérlő DLL-ből regisztrálja az egyes közös vezérlőosztályokat. |
InitMUILanguage | Lehetővé teszi egy alkalmazás számára, hogy a rendszernyelvtől eltérő közös vezérlőkkel használandó nyelvet adjon meg. |
LoadIconMetric | Betölt egy megadott ikonerőforrást egy ügyfél által megadott rendszermetrikával. |
LoadIconWithScaleDown | Betölt egy ikont. Ha az ikon nem szabványos méretű, akkor ez a függvény a kisebb kép méretezése helyett egy nagyobb képet skáláz le. |
MirrorIcon | Megfordítja a tükrözött ikonokat, hogy megfelelően jelenjenek meg egy tükrözött eszközkörnyezetben. |
PFNDACOMPARE | Meghatározza a DSA_Sortáltal használt összehasonlítási függvény prototípusát. |
PFNDACOMPARECONST | Meghatározza a DSA_Sort által használt összehasonlítási függvény prototípusát, amikor az összehasonlítandó elemek állandó objektumok. |
PFNDAENUMCALLBACK | Meghatározza a DSA és a DPA függvény által használt visszahívási függvény prototípusát. |
PFNDAENUMCALLBACKCONST | Meghatározza a DSA és a DPA függvény által használt visszahívási függvény prototípusát, amikor az érintett elemek állandó adatokra mutatnak. |
PFNDPACOMPARE | Meghatározza a DPA_Sort és DPA_Searcháltal használt összehasonlítási függvény prototípusát. |
PFNDPACOMPARECONST | Meghatározza a DPA_Sort vagy DPA_Search által használt összehasonlítási függvény prototípusát, amikor az összehasonlítandó elemek állandó objektumok. |
PFNDPAENUMCALLBACK | Meghatározza a DPA_EnumCallbackáltal használt visszahívási függvény prototípusát. |
PFNDPAMERGE | Meghatározza a DPA_Mergeáltal használt egyesítési függvény prototípusát. |
PFNDPAMERGECONST | A DPA_Mergeáltal használt egyesítési függvény prototípusát határozza meg állandó értékekkel. |
PFNDPASTREAM | Meghatározza a DPA_LoadStream és DPA_SaveStreamáltal használt visszahívási függvény prototípusát. |
PFNDSAENUMCALLBACK | Meghatározza a DSA_DestroyCallbackáltal használt visszahívási függvény prototípusát. |
ReaderScroll | Alkalmazás által definiált visszahívási függvény, amely akkor használatos, ha az egérmutatót az olvasó mód ablakának aktív görgetési területként deklarált részen belül helyezi át. |
ShowHideMenuCtl | Beállítja vagy eltávolítja a megadott menüelem pipa attribútumát, és megjeleníti vagy elrejti a megfelelő vezérlőt. A függvény pipát ad a megadott menüelemhez, ha nincs, majd megjeleníti a megfelelő vezérlőt. Ha a menüelem már rendelkezik pipával, a függvény eltávolítja a pipát, és elrejti a megfelelő vezérlőt. |
Str_GetPtr | Sztringet másol az egyik pufferből a másikba. |
Str_SetPtrW | Beállítja ppszCurrentpszNew másolatára, és szükség esetén felszabadítja az előző értéket. |
TranslateDispatch | A DoReaderMode függvény ügyfele használja az olvasó mód ablakának görgetési területére célzott ablaküzenetek elfogására és explicit kezelésére. Ez egy alkalmazás által definiált visszahívási függvény. |
Makrók
Téma | Tartalomjegyzék |
---|---|
DPA_AppendPtr | Új elemet szúr be egy DPA végére. |
DPA_FastDeleteLastPtr | Törli az utolsó mutatót egy DPA-ból. |
DPA_FastGetPtr | Lekéri a megadott mutató értékét a DPA-ban. |
DPA_GetPtrCount | A DPA mutatóinak számát adja meg. |
DPA_GetPtrPtr | Lekéri az egérmutatót egy DPA belső mutatótömbje felé. |
DPA_SetPtrCount | A DPA mutatóinak számát állítja be. |
DPA_SortedInsertPtr | Új elemet szúr be egy megadott meglévő elem elé vagy után. |
DSA_AppendItem | Hozzáfűz egy új elemet egy DSA végéhez. |
DSA_GetItemCount | Lekéri a DSA elemeinek számát. |
FORWARD_WM_NOTIFY | Elküldi vagy közzéteszi a WM_NOTIFY üzenetet. |
HANDLE_WM_NOTIFY | Meghív egy függvényt, amely feldolgozza a WM_NOTIFY üzenetet. |
INDEXTOSTATEIMAGEMASK | Előkészíti az állapotkép indexét, hogy egy fanézetű vezérlő vagy listanézet vezérlőelem az index használatával lekérhesse az elem állapotképét. |
Üzenetek
Téma | Tartalomjegyzék |
---|---|
CCM_DPISCALE | Lehetővé teszi Tree-View vezérlők, List-View vezérlők, ComboBoxEx vezérlők, Fejlécvezérlők, Gombok, Eszköztár vezérlők, Animáció vezérlőkés Képlisták. |
CCM_GETUNICODEFORMAT | Lekéri a vezérlő Unicode-karakterformázási jelzőt. |
CCM_GETVERSION | Lekéri a legújabb CCM_SETVERSION üzenet által beállított vezérlőelem verziószámát. |
CCM_SETUNICODEFORMAT | Beállítja a vezérlő Unicode karakterformátum-jelölőjének beállítását. Ez az üzenet lehetővé teszi, hogy futásidőben módosítsa a vezérlő által használt karakterkészletet a vezérlő újbóli létrehozása helyett. |
CCM_SETVERSION | Ez az üzenet arról tájékoztatja a vezérlőt, hogy egy adott verzióhoz kapcsolódó viselkedést vár. |
CCM_SETWINDOWTHEME | Beállítja egy vezérlőelem vizuális stílusát. |
WM_NOTIFY | Egy közös vezérlő küldi el a szülőablakba, amikor esemény történt, vagy a vezérlő némi információt igényel. |
WM_NOTIFYFORMAT | Meghatározza, hogy egy ablak elfogadja-e az ANSI- vagy Unicode-struktúrákat a WM_NOTIFY értesítési üzenetben.
WM_NOTIFYFORMAT üzeneteket a rendszer egy közös vezérlőből a szülőablakba, a szülőablakból pedig a közös vezérlőbe küldi. |
Értesítések
Téma | Tartalomjegyzék |
---|---|
NM_CHAR | A NM_CHAR értesítési kódot egy vezérlő küldi el egy karakterkulcs feldolgozásakor. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_CUSTOMDRAW | Értesíti a vezérlő szülőablakát az egyéni rajzműveletekről. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_CUSTOMTEXT | Értesíti a vezérlő szülőablakát az egyéni szövegműveletekről. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_FONTCHANGED | Listanézet-vezérlő küldi el, ha a vezérlő módosított egy betűtípust. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_GETCUSTOMSPLITRECT | Egy gombvezérlő küldi el a szülőnek az osztott gombot alkotó két téglalap méréseinek lekéréséhez. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_HOVER | Egy vezérlő küldi el, amikor az egér rámutat egy elemre. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_KEYDOWN | Egy vezérlő küldi el, ha a vezérlő fókusza a billentyűzetre kerül, és a felhasználó lenyom egy billentyűt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_KILLFOCUS | Értesíti a vezérlő szülőablakát, hogy a vezérlő elvesztette a bemeneti fókuszt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_LDOWN | Értesíti a vezérlő szülőablakát, hogy a bal egérgombot lenyomta. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_NCHITTEST | Ha a vezérlő WM_NCHITTEST üzenetet kap, egy rebar vezérlő küldi el. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_OUTOFMEMORY | Értesíti a vezérlő szülőablakát, hogy a vezérlő nem tudott végrehajtani egy műveletet, mert nem volt elegendő memória. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_RDOWN | Jelenleg nem támogatott. |
NM_RELEASEDCAPTURE | Értesíti a vezérlő szülőablakát, hogy a vezérlő egérrögzítést bocsát ki. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_RETURN | Értesíti a vezérlő szülőablakát, hogy a vezérlő fókusza a bemeneti fókusz, és hogy a felhasználó lenyomta az ENTER billentyűt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_SETCURSOR | Értesíti a vezérlő szülőablakát, hogy a vezérlő egy NM_SETCURSOR üzenetre válaszul állítja be a kurzort. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_SETFOCUS | Értesíti a vezérlő szülőablakát, hogy a vezérlő megkapta a bemeneti fókuszt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_THEMECHANGED | Értesíti a vezérlő szülőablakát, hogy a téma megváltozott. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_TOOLTIPSCREATED | Értesíti a vezérlő szülőablakát, hogy a vezérlő létrehozott egy elemleírás-vezérlőt. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
NM_TVSTATEIMAGECHANGING | Egy fanézet vezérlőelem küldi el a szülőablakba, hogy az állapotkép megváltozik. Ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el a rendszer. |
Struktúrák
Téma | Tartalomjegyzék |
---|---|
COLORSCHEME | Az eszköztár vagy a sáv gombjainak rajzára vonatkozó információkat tartalmazza. |
DPASTREAMINFO | A PFNDPASTREAM visszahívási függvény által használt streamelemet tartalmazza. |
INITCOMMONCONTROLSEX | A dinamikus csatolású kódtárból (DLL) származó gyakori vezérlőosztályok betöltéséhez használt információkat tartalmazza. Ez a struktúra az InitCommonControlsEx függvénnyel használható. |
NMCHAR | A karakterértesítési üzenetekhez használt információkat tartalmazza. |
NMCUSTOMSPLITRECTINFO | Az osztott gomb két téglalapjáról tartalmaz információt. A NM_GETCUSTOMSPLITRECT értesítéssel küldve. |
NMCUSTOMTEXT | Egyéni szöveges értesítéshez használt információkat tartalmaz. |
NMHDR | Információt tartalmaz egy értesítési üzenetről. |
NMKEY | A kulcsértesítési üzenetekhez használt információkat tartalmazza. |
NMMOUSE | Az egér értesítési üzeneteivel kapcsolatos információkat tartalmazza. |
NMOBJECTNOTIFY | A TBN_GETOBJECT, TCN_GETOBJECTés PSN_GETOBJECT értesítési kódokkal használt információkat tartalmazza. |
NMTOOLTIPSCREATED | Az értesítési kód NM_TOOLTIPSCREATED használt információkat tartalmazza. |
READERMODEINFO | A DoReaderMode függvény inicializálásához szükséges információkat tartalmazza. |
Állandók
Téma | Tartalomjegyzék |
---|---|
CDRF-állandók | Ezeket az állandókat egy vezérlő egy NM_CUSTOMDRAW értesítési kódra válaszul használja eredményértékként. |
Stílusok | Ez a szakasz a gyakori vezérlőstílusokat sorolja fel. A feljegyzett esetek kivételével ezek a stílusok a fejlécvezérlőkre, az eszköztár-vezérlőkre és az állapotablakokra vonatkoznak. |
ablakosztályok | Ez a szakasz a közös vezérlőtár által megadott ablakosztályneveket sorolja fel. |