Sdílet prostřednictvím

Příprava konfiguračního souboru pro prostředky

Nástroje kompilátoru MUIRCT i RC popsané v nástrojích Resource Utilities poskytují možnost příkazového řádku, která umožňuje zadat konfigurační soubor prostředků pro prostředky základního jazyka. Použití tohoto veřejného souboru XML čitelného člověkem umožňuje větší kontrolu nad rozdělením prostředků, než lze získat pomocí běžných přepínačů příkazového řádku nástrojů. I když nezadáte konfigurační soubor prostředku jako vstup, soubory LN a soubory prostředků specifické pro jazyk budou obsahovat konfigurační data prostředků.

Všechny konfigurační soubory prostředků pro aplikace Win32 začínají a končí identicky:

<?xml version="1.0" encoding="utf-8"?> 
<localization>

<resources>
        
        <!-- a single win32Resources element goes here -->

</resources>
</localization>

Toto téma se zaměřuje na aspekty schématu XML, které jsou užitečné při vytváření nespravovaného kódu v systému Windows Vista a novějších verzích. Konkrétně se zabývá pouze chováním prvku win32Resources.

win32Resources – Element

Element win32Resources má atributy popsané v následující tabulce.

Název atributu Povinný Popis
typ souboru Ne Typ souboru. Vždy by mělo být "Aplikace".
kontrolní součet Ne Hodnota kontrolního součtu se objeví v konfiguračních datech prostředků LN souboru a v souborech prostředků specifických pro jazyk. Tento atribut například umožňuje zkopírovat kontrolní součet z jednoho souboru prostředků specifického pro jazyk podle konvence pro angličtinu (Spojené státy) a umístit kontrolní součet do jiného souboru prostředků specifického pro jazyk. Kontrolní součet lze zadat jako šestnáctkový číselný řetězec, který není delší než 32 znaků. Číselná hodnota musí být obsažena v 128bitovém čísle.
Jazyk Ne Značka jazyka kompatibilní s IETF BCP 47 (Windows Vista a novější), například en-US pro angličtinu (Spojené státy).
ultimateFallbackLanguage Ne Jazyk, který má být vložen do konfiguračních dat prostředků souboru LN, představuje konečný záložní jazyk, který se použije při hledání odpovídajícího jazykově specifického souboru prostředků. Pokud nahrávač prostředků nenahraje požadovaný soubor zdrojů z preferovaných jazyků uživatelského rozhraní vlákna, použije jako poslední možnost záložní jazyk. Značka jazyka kompatibilní s IETF BCP 47 (Windows Vista a novější), například en-US pro angličtinu (Spojené státy).
ultimateFallbackLocation Ne Záložní umístění. Pokud jsou do souboru LN zkompilovány konečné záložní prostředky, zadejte "interní". Zadejte "externí" (výchozí), pokud soubor LN odkazuje na soubor prostředků specifický pro jazyk pro jeho konečné záložní prostředky.

V konfiguračním souboru prostředků má element win32Resources dílčí prvky popsané v další tabulce.

Název elementu Popis
lokalizované zdroje Zdroje, které obsahují informace o typech prostředků a jednotlivých prostředcích obsažených v souboru prostředků specifický pro jazyk.
neutralResources Zdroje, které shrnují informace o typech zdrojů obsažených v souboru LN.

Element lokalizovanéZdroje

Lokalizovaný prvek zdrojů Ve výchozím nastavení tento prvek nemá žádné atributy a pouze jeden typ dílčího elementu. Jedná se pouze o kontejner pro elementy resourceType.

Název atributu Popis
typ zdroje Typ jednotlivého prostředku obsaženého v souboru prostředků specifického pro jazyk.

neutralResources prvek

Element neutrálních zdrojů Tento element je pouze kontejner pro elementy resourceType.

Název atributu Popis
typ zdroje Typ jednoho prostředku obsaženého v souboru LN.

resourceType – element

Element resourceType zapouzdřuje informace o jednom typu prostředku nebo jednotlivém prostředku. Má atributy uvedené níže.

Opatrnost

Některé vady konfigurace prostředků jsou zachyceny pouze kompilátorem RC nebo MUIRCT v závislosti na vstupním souboru prostředků nebo binárním souboru obsahu. Chyby resourceType v konfiguračním souboru prostředků, které neexistují ve vstupním souboru, nejsou zachyceny, což vede k neočekávanému chování. Uživatelé mohou používat vadný konfigurační soubor a to nezjistí, dokud nezavedou binární soubory, které používají poškozené části konfiguračního souboru, což budí dojem, že problémy pocházejí ze stávajících binárních souborů.

Název atributu Povinný Popis
typeNameId Ano Zadejte název nebo identifikátor prostředku. Zadejte název řetězce nebo číslo. Pokud používáte číslo, přidejte před řetězec znak "#", čímž označíte, že představuje číslo. Každý prvek resourceType musí mít pouze jeden typeNameId atributu.
název položky Ne Řetězec názvu položky pro prostředek, který se má umístit do jazykově specifického souboru prostředků. Můžete zadat více názvů oddělených prázdnými znaky, například HTML MOFDATA.
ID položky Ne Identifikátor jednotlivé položky prostředku, který se má umístit do souboru prostředků specifického pro jazyk. Položku lze zadat jako rozsah (například "1–12") nebo podle jednotlivých identifikátorů oddělených prázdnými znaky (například "1 3 4").
stringId Ne Identifikátor řetězce pro jednotlivou položku zdroje, který se umístí do jazykově specifického souboru zdrojů. Řetězec lze zadat jako rozsah (například "1–12") nebo podle jednotlivých identifikátorů oddělených prázdnými mezerami (například "1 3 4"). Tento atribut umožňuje specifikaci lokalizovatelných i nelokalizovatelných položek tabulky řetězců. Musí být použit ve spojení s typeNameId hodnotu "6", která označuje typ vstupního prostředku tabulky řetězců.
Řetězce jsou uložené v blocích 16 v řetězcové tabulce. Například řetězce 0 až 15 jsou uloženy v jednom bloku položky prostředku a lze na ni odkazovat v konfiguračním souboru prostředků jako itemId 1 nebo jako stringId "0-15". Pokud je například pět lokalizovatelných řetězců a tři nelokalizovatelné řetězce, měli byste identifikátory řetězců přiřadit 0–4 pro lokalizovatelné řetězce a identifikátory řetězců 16–18 pro nelokalizovatelné řetězce. Pokud tímto způsobem neuspořádáte řetězce, příslušné bloky řetězců se umístí do souboru LN i do souboru prostředků specifického pro jazyk.

Pokud zadáte itemName, itemId, a/nebo stringId atributy pro určitý typ prostředku v lokalizovanýResource elementu, umístí se do souboru prostředků specifického jazyka pouze tyto položky nebo řetězce pro určený typ prostředku. Pokud je prvek resourceType zadán bez explicitního názvu položky, identifikátoru položky nebo identifikátoru řetězce, všechny položky zadaného typu prostředku se umístí do souboru prostředků specifického pro jazyk. Položky nebo typy, které nejsou uvedeny v žádném elementu localizedResource, budou umístěny v souboru LN.

Níže jsou uvedené standardní typy prostředků a jejich číselné identifikátory:

  • CURSOR(1)
  • BITMAP(2)
  • ICON(3)
  • MENU(4)
  • DIALOG(5)
  • STRING(6)
  • FONTDIR(7)
  • FONT(8)
  • AKCELERÁTORY(9)
  • RCDATA(10)
  • MESSAGETABLE(11)
  • GROUP_CURSOR(12)
  • GROUP_ICON(14)
  • VERSION(16)
  • HTML(23)

Příklad

<?xml version="1.0" encoding="utf-8"?> 
<localization>
  <resources>
    <win32Resources fileType="Application">
      <neutralResources>
        <resourceType
           typeNameId="#16"
        />
      </neutralResources>
      <localizedResources> 
         <resourceType
                typeNameId="#2"
                itemId="5 6 7 8 9 10 11 12"
                itemName="HTML PRI"
         />
         <resourceType
                typeNameId="#4"
         />
         <resourceType
                typeNameId="#5"
         />
         <resourceType
                typeNameId="#6"
         />
         <resourceType
                typeNameId="#9"
         />
         <resourceType
                typeNameId="#11"
         />
         <resourceType
                typeNameId="#16"
         />
         <resourceType
                typeNameId="HTML"
         />
         <resourceType
                typeNameId="#23"
         />
         <resourceType
                typeNameId="#240"
         />
         <resourceType
                typeNameId="#1024"
         />
         <resourceType
                typeNameId="MY_TYPE"
         />
      </localizedResources> 
    </win32Resources>
  </resources>
</localization>

Poznámky

Pokud do elementu neutralResources zahrnete jakýkoli typ prostředku ICON(3), DIALOG(5), STRING(6) nebo VERSION(16), musíte tuto položku duplikovat v elementu localizedResources. Můžete to vidět v příkladu výše, kde se typ prostředku 16 zobrazuje v oddílech neutrálních i lokalizovaných prostředků.

Příprava Prostředků

  • Last updated on