Informacje o interfejsie API sprawdzania pisowni

Dla użytkowników na całym świecie wprowadzanie tekstowe jest częścią nowoczesnego środowiska obliczeniowego, na potrzeby blogowania, komentowania, tweetowania, wiadomości błyskawicznych lub dowolnego innego rodzaju wpisywania tekstu. W systemie Windows 8 sprawdzanie pisowni jest wbudowane w pola edycji.

Deweloperzy mogą używać interfejsu API sprawdzania pisowni w swoich aplikacjach do korzystania z dostępnych usług sprawdzania pisowni. Deweloperzy mogą również tworzyć moduły sprawdzania pisowni, które stają się dostawcami i są zintegrowane ze strukturą sprawdzania pisowni systemu Windows.

Interfejs API sprawdzania pisowni jest przeznaczony do użycia przez profesjonalnych deweloperów C/C++ aplikacji modelu obiektów składników systemu Windows (COM). Interfejs API sprawdzania pisowni nie jest obsługiwany do użycia w systemie Windows ani w usłudze ASP.NET.

Wersjonowanie

Interfejs API sprawdzania pisowni jest dostępny od systemu Windows 8 lub Windows Server 2012. Przyszłe dodatki do API będą obsługiwane przez utworzenie nowych interfejsów, które można określić za pomocą istniejących QueryInterface.

Interfejsy

Wszystkie interfejsy muszą być zwalniane z użycia, gdy nie są już używane. Wszystkie zwrócone (parametr out) ciągi LPWSTR (i elementy LPOLESTR z IEnumString) muszą być zwalniane z CoTaskMemFree, gdy nie są już używane.

Obsługa błędów

Błędy są zwracane jako HRESULTs. IErrorInfo i ISupportErrorInfo nie są obsługiwane w tym API. Błędy nie są szczególnie możliwe do rozwiązania z wyjątkiem nieprawidłowych argumentów.

Standardowe kody błędów RPC mogą być zwracane przez dowolne wywołania interfejsu API, ponieważ są one wykonywane poza procesem. Obowiązują standardowe limity czasu RPC.

Bezpieczeństwo

Interfejs API sprawdzania pisowni może załadować zewnętrzny kod (od dostawców usługi sprawdzania pisowni). Spowoduje to uruchomienie tego kodu poza procesem i w kontekście zabezpieczeń o ograniczonym dostępie.

Pliki słownika

Słowniki specyficzne dla użytkownika dla danego języka, które przechowują zawartość list wyrazów Dodane, Wykluczone i Autokorekta, znajdują się pod ścieżką %AppData%\Microsoft\Spelling\<tag języka>. Nazwy plików to default.dic (Dodane), default.exc (Wykluczone) i default.acl (Autokorekta). Pliki to zwykły tekst UTF-16 LE, który musi zaczynać się od odpowiedniego znaku kolejności bajtów (BOM). Każda linia zawiera słowo (na listach dodanych i wykluczonych słów) lub parę słów do autokorekty ze słowami oddzielonymi pionowym paskiem ("|") (na liście słów Autokorekty). Inne pliki .dic, .exc i .acl obecne w katalogu zostaną wykryte przez usługę sprawdzania pisowni i dodane do list wyrazów użytkownika. Te pliki są uważane za tylko do odczytu i nie są modyfikowane przez interfejs API sprawdzania pisowni.

Instalowanie dostawcy sprawdzania pisowni

Instalacja dostawcy weryfikacji pisowni musi przechowywać wszystkie pliki w lokalizacji, która umożliwia dostęp do odczytu z identyfikatora SID (identyfikator zabezpieczeń) "WSZYSTKIE PAKIETY APLIKACJI". Zainstalowanie go w folderze w obszarze "Program Files" działa dobrze. Ponadto dostawca musi ustawić niektóre klucze w rejestrze, aby był widoczny dla interfejsu API sprawdzania pisowni. Może to być gałąź HKEY_CURRENT_USER lub gałąź HKEY_LOCAL_MACHINE w zależności od tego, czy powinna być zainstalowana tylko dla bieżącego użytkownika, czy wszystkich użytkowników.

Key: <Registry hive>\SOFTWARE\Classes\CLSID\<Server CLSID>
     Default (REG_SZ) = <Name of the provider>

Key: <Registry hive>\SOFTWARE\Classes\CLSID\<Server CLSID>\InprocServer32
     ThreadingModel (REG_SZ) = "Both"

Key: <Registry hive>\SOFTWARE\Classes\CLSID\<Server CLSID>\Version
     Version (REG_SZ) = <Version>

Key: <Registry hive>\SOFTWARE\Microsoft\Spelling\Spellers\<Provider id string>
     CLSID (REG_SZ) = <CLSID of the COM Server that implements the provider>

Przykład dostawcy sprawdzania pisowni pokazuje przykład rejestracji wymaganej do zainstalowania dostawcy.

Jeśli tworzysz nowe opcje sprawdzania pisowni dla dostawcy sprawdzania pisowni, zobacz IOptionDescription::Id, aby uzyskać wskazówki dotyczące nazewnictwa.

Tematy pokrewne

Dokumentacja interfejsu API do sprawdzania pisowni

przykładowy klient sprawdzania pisowni

przykład dostawcy sprawdzania pisowni

IOptionDescription::Id

IEnumString

QueryInterface