Formant XMLNodes

Artykuł
06/10/2015

Ważne informacje określone w tym temacie dotyczące programu Microsoft Word jest prezentowane wyłącznie dla użytku osób i organizacji, którzy znajdują się poza terenem Stanów Zjednoczonych i jej terytoriów lub którzy są przy użyciu lub opracowywanie programów, które działają na produkty Microsoft Word, które są licencjonowane przez firmę Microsoft przed stycznia 2010 r., kiedy firma Microsoft usunęła wykonania konkretnej funkcji związanych z niestandardowych danych XML z programu Microsoft Word i korzyści.Te informacje dotyczące programu Microsoft Word nie może odczytać lub używane przez osoby lub organizacje w Stanach Zjednoczonych lub w jego obszarze, którzy za pomocą lub opracowywanie programów, które działają na produkty Microsoft Word, które są licencjonowane przez firmę Microsoft po 10 stycznia 2010 r.; tych produktów nie będzie tak samo jak produkty licencjonowane przed tą datą lub zakupione i licencje użytkowania poza Stanami Zjednoczonymi.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do projektów na poziomie dokumentu obsługiwanych w programach Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacjach pakietu Office i typ projektu.

XMLNodes Kontroli jest kolekcją obiektów węzła XML mapowanej opisuje zdarzenia.XMLNodes Kontroli jest tworzony tylko wtedy, gdy powtarzający się element schematu jest mapowany na dokument programu Microsoft Office Word.Jeśli powtarzający się element zawiera elementy podrzędne, każdy z elementów podrzędnych tworzony jest także jako XMLNodes kontroli.

Po Visual Studio tworzy zbiór węzłów XML, można zaprogramować przeciwko kontroli bezpośrednio bez konieczności przechodzenia modelu obiektów programu Word.XMLNodes Formantu można usunąć tylko przez usunięcie mapowania elementu z dokumentu.

[!UWAGA]

Jeśli dostęp jest elementem podrzędnym elementu XMLNodes kontroli przez Item właściwość, zwraca XMLNode obiektu, a nie XMLNode kontroli.Aby uzyskać więcej informacji, zobacz Ograniczenia programowe elementów hosta i formantów hosta.

Wiązanie danych do formantu

XMLNodes Kontroli nie obsługuje wiązania z danymi.Wynika to z XMLNodes formant nie ma powiązania możliwości złożonych danych i wiązania danych prosty nie może reprezentować powtarzających się danych.

Formatowanie

Wszelkie formatowanie, które mogą być stosowane do tekstu w dokumencie, mogą być stosowane do XMLNodes kontroli.

Zdarzenia

Zdarzenia dostępne dla XMLNodes kontroli są:

Porównanie wydarzenia

Można przechwytywać zdarzenia, gdy użytkownik przesuwa kursor lub jej wewnątrz kontekstu danego XMLNodes kontroli.Na przykład, może być XMLNodes sterowania o nazwie Customer który ma dziecko XMLNodes sterowania o nazwie Company, i Company ma dwa dziecko XMLNodes kontroli o nazwie CompanyName i CompanyRegion następująco:

<Customer>
    <Company>
        <CompanyName>
        <CompanyRegion>

Jeśli chcesz pokazać formant w okienku Akcje gdy kursor jest przesuwany do Company węzła, należy nie znaczenia czy kursor jest umieszczony w CompanyName lub CompanyRegion , ponieważ są one zarówno w ramach Company.W takim przypadku można napisać kod ContextEnter przypadku Company.

W większości przypadków, gdy kursor wchodzi XMLNodes kontroli, zarówno Select i ContextEnter zdarzenia są wywoływane.W poniższej tabeli przedstawiono różnice między tymi zdarzeniami.

Wybierz zdarzenie	Zdarzenie ContextEnter
Występuje, gdy kursor jest umieszczony wewnątrz jednego z węzłów z XMLNodes kolekcji.	Występuje, gdy kursor jest umieszczony wewnątrz jednego z węzłów lub węzły podrzędne z XMLNodes do kolekcji, obszar poza kontekstem węzła.Innymi słowy, jest wywoływane tylko wtedy, gdy zmienia kontekst i może zostać podniesiony do wielu zagnieżdżonych XMLNodes kontroli.

Na przykład, kiedy kursor z poza Customer do CompanyName, ContextEnter zdarzenia dla Customer, Company, i CompanyName są podniesione.Jeśli następnie przenieś kursor z CompanyName do CompanyRegion, ContextEnter zdarzenie tylko dla CompanyRegion powstaje, ponieważ kontekst jest taka sama dla obu Company i Customer.Może mieć wielu Company węzłów w dokumencie.Po przesunięciu kursora z CompanyName węzeł jednego Company do CompanyName węzeł innego Company, kontekst jest takie same, więc tylko Select zdarzenie jest wywoływane.

Tym samym różnice między ContextLeave zdarzenia i Deselect zdarzenie.