Jak pracovat se seznamy v .NET

Krok 1: Použít seznam na odstavec

Použijte ListFormat.ApplyBulletDefault() nebo ApplyNumberDefault() na formátování odstavce k aplikaci výchozího odrážkového nebo číslovaného seznamu ve Wordu jedním voláním — to je nejrychlejší způsob, jak použít standardní seznam. Pro konkrétní předdefinovaný formát místo výchozího zavolejte Document.Lists (a ListCollection) .Add(listTemplate) s hodnotou ListTemplate, například BulletDisk, BulletSquare, NumberArabicDot nebo NumberUppercaseRomanDot, abyste vytvořili List z jednoho z vestavěných formátů ve Wordu, nebo AddSingleLevelList(listTemplate) pro variantu s jednou úrovní. Jakmile má odstavec formátování seznamu, ListFormat.IsListItem hlásí true a ListFormat.List/ListLevelNumber identifikují, který seznam a úroveň používá.

Krok 2: Přidělit nové skupině odstavců samostatné číslování

Odstavce, jejichž ListFormat.List ukazuje na stejný sdílený objekt List, pokračují ve stejném číslování. Když nová skupina odstavců potřebuje číslování, které se nezávisle restartuje od 1, zavolejte ListCollection.AddCopy(srcList) k duplikaci existující definice seznamu a poté použijte kopii na nové odstavce místo opětovného použití originálu. ListCollection.GetListByListId(listId) načte konkrétní seznam podle jeho ListId, když jej potřebujete najít místo vytvoření nového, a Count udává, kolik seznamů dokument aktuálně obsahuje.

Krok 3: Přesunout odstavec mezi úrovněmi seznamu

Použijte ListFormat.ListIndent() k přesunu odstavce o jednu úroveň hlouběji v jeho seznamu a ListOutdent() k přesunu o jednu úroveň výše — stejné operace, které Word provádí pomocí Tab a Shift+Tab na začátku odstavce seznamu. Upřednostněte tyto metody před přímým nastavením ListLevelNumber, protože zachovávají interní konzistenci formátování seznamu odstavce. Zavolejte RemoveNumbers() k úplnému odebrání formátování seznamu z odstavce.

Krok 4: Přizpůsobit formát číslování úrovně seznamu

Cílovou úroveň získáte pomocí List.ListLevels (jedná se o ListLevelCollection), poté nastavte ListLevel.NumberStyle (hodnota NumberStyle, např. Arabic, UppercaseRoman, LowercaseLetter nebo Bullet) a NumberFormat — formátovací řetězec, který spojuje číslo s doslovným textem, jako je tečka nebo závorka — společně, protože nesoulad mezi nimi vede k neočekávanému vykreslení. StartAt určuje počáteční číslo úrovně a RestartAfterLevel určuje, čího vyšší úrovně inkrement restartuje čítač této úrovně — nastavte jej explicitně u vnořených seznamů místo spoléhání se na výchozí chování restartu. Alignment (Left, Center, Right) a TrailingCharacter (Tab, Space, Nothing) řídí umístění popisku a oddělovač mezi popiskem a textem odstavce, spolu s TabPosition, NumberPosition a TextPosition pro přesné rozvržení. IsLegal vynutí číslování ve stylu zákona (vždy arabské), bez ohledu na NumberStyle.

Krok 5: Přidat obrázkový odrážkový znak do úrovně seznamu

Zavolejte ListLevel.CreatePictureBullet() na cílové úrovni pro vytvoření definice obrázkového odrážkového znaku, poté zadejte ImageData odrážky před odstraněním jakéhokoli existujícího textového odrážkového formátování na stejné úrovni. Zavolejte DeletePictureBullet() k odstranění obrázkového odrážkového znaku a návratu k textovému odrážkovému formátování.

Krok 6: Prozkoumat vykreslený popisek položky seznamu

ListLabel popisuje štítek, který je ve skutečnosti vykreslen pro jednu instanci položky seznamu, získaný z formátování odstavce položky. LabelString je doslovný text, který Word zobrazuje — například “3.” nebo “•” — LabelValue je základní číselná hodnota a Font je vlastní formátování štítku, nezávislé na formátování textu odstavce. Pro výpočet hodnoty štítku na libovolné pozici v sekvenci bez vykreslování celého seznamu zavolejte ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat).