IOptionDescription::Id property

Gets the identifier of the spell checker option.

This property is read-only.

Syntax


HRESULT get_Id(
  [out, retval]  LPWSTR *value
);

Property value

The option id. This is never the empty string or a null pointer.

Error codes

NameMeaning
S_OK

Successful.

Remarks

Option identifiers all exist in the same area. Spell checker providers should use the engine identifier and the language tag (if the option is language-specific) to disambiguate potential collisions. Specifically, the structure for naming the option identifiers should be:

  • For the Microsoft spell checker engine: <language tag>:<option name>. For example, "pt-BR:2009Reform."
  • For spell check provider engines: <engine id>:<language tag>:<option name> (the language tag may be omitted if the option is not language specific). For example, "samplespell:fr-FR:AccentedUppercase".
Note  Spell check providers are allowed to support existing Microsoft option identifiers, but they must not create new option identifiers in the Microsoft namespace. That is, spell check providers must use the engine identifier as a prefix.

An option identifier is linked to the set of labels and the semantics associated with them. If any change needs to be made between versions to the option (adding a label to the set of labels), a new option with a new identifier must be used. The only valid change that does not require a new identifier is to change from a single label to two labels and vice-versa when the semantics for values 0 and 1 do not change.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

Spellcheck.h

IDL

Spellcheck.idl

See also

IOptionDescription

 

 

Community Additions

ADD
Show:
© 2015 Microsoft