Win32-OLE-0.1502 > Win32::OLE::NLS
Win32-OLE-0.1502
Other versions:
libwin32-0.26

名前

Win32::OLE::NLS - OLE National Language Support

Win32::OLE::NLS - OLE 各国語サポート

概要

        missing

説明

This module provides access to the national language support features in the OLENLS.DLL.

このモジュールは OLENLS.DLL の各国語サポート機能へのアクセスを提供します。

関数

CompareString(LCID,FLAGS,STR1,STR2)

Compare STR1 and STR2 in the LCID locale. FLAGS indicate the character traits to be used or ignored when comparing the two strings.

LCID ロケールで STR1 と STR2 を比較します。 FLAGS は二つの文字列を比較する際に使用される、あるいは無視される文字の 特徴を示します。

        NORM_IGNORECASE         Ignore case
        NORM_IGNOREKANATYPE     Ignore hiragana/katakana character differences
        NORM_IGNORENONSPACE     Ignore accents, diacritics, and vowel marks
        NORM_IGNORESYMBOLS      Ignore symbols
        NORM_IGNOREWIDTH        Ignore character width
        NORM_IGNORECASE         大文字と小文字を区別しない
        NORM_IGNOREKANATYPE     ひらがなとカタカナを区別しない
        NORM_IGNORENONSPACE     アクセント、付加記号、発音記号を無視する
        NORM_IGNORESYMBOLS      記号を無視する
        NORM_IGNOREWIDTH        文字列の幅を無視する

Possible return values are:

あり得る戻り値は以下の通りです:

        0       Function failed
        1       STR1 is less than STR2
        2       STR1 is equal to STR2
        3       STR1 is greater than STR2
        0       関数が失敗
        1       STR1 は STR2 よりも小さい
        2       STR1 は STR2 と同じ
        3       STR1 は STR2 よりも大きい

Note that you can subtract 2 from the return code to get values comparable to the cmp operator.

cmp 演算子と比較できる値を取得するために、戻り値から 2 を引くことが できることに注意してください。

LCMapString(LCID,FLAGS,STR)

LCMapString translates STR using LCID dependent translation. Flags contains a combination of the following options:

LCMapString は LCID に依存した変換で STR を変換します。 フラグには以下のオプションの組み合わせが入ります:

        LCMAP_LOWERCASE         小文字化
        LCMAP_UPPERCASE         大文字化
        LCMAP_HALFWIDTH         半角化
        LCMAP_FULLWIDTH         全角化
        LCMAP_HIRAGANA          ひらなが化
        LCMAP_KATAKANA          カタカナ化
        LCMAP_SORTKEY           正規化されたワイド文字のソートキーを作成

The following normalization options can be combined with LCMAP_SORTKEY:

以下の正規化オプションを LCMAP_SORTKEY に組み合わせることができます:

        NORM_IGNORECASE         Ignore case
        NORM_IGNOREKANATYPE     Ignore hiragana/katakana character differences
        NORM_IGNORENONSPACE     Ignore accents, diacritics, and vowel marks
        NORM_IGNORESYMBOLS      Ignore symbols
        NORM_IGNOREWIDTH        Ignore character width
        NORM_IGNORECASE         大文字と小文字を区別しない
        NORM_IGNOREKANATYPE     ひらがなとカタカナを区別しない
        NORM_IGNORENONSPACE     アクセント、付加記号、発音記号を無視する
        NORM_IGNORESYMBOLS      記号を無視する
        NORM_IGNOREWIDTH        文字列の幅を無視する

The return value is the translated string.

戻り値は変換された文字列です。

GetLocaleInfo(LCID,LCTYPE)

Retrieve locale setting LCTYPE from the locale specified by LCID. Use LOCALE_NOUSEROVERRIDE | LCTYPE to always query the locale database. Otherwise user changes to win.ini through the windows control panel take precedence when retrieving values for the system default locale. See the documentation below for a list of valid LCTYPE values.

ロケール設定 LCTYPE を LCID で指定されたロケールから取り出します。 ロケールデータベースに問い合わせるためには常に LOCALE_NOUSEROVERRIDE | LCTYPEを使ってください。 そうでなければ値を取り出す際に、Windows コントロールパネルを通じて ユーザによる win.ini に変更が、システムデフォルトロケールよりも 優先されます。 下記の適切な LCTYPE 値のリストについての文章をご覧ください。

The return value is the contents of the requested locale setting.

戻り値は要求されたロケール設定の内容です。

GetStringType(LCID,TYPE,STR)

Retrieve type information from locale LCID about each character in STR. The requested TYPE can be one of the following 3 levels:

ロケール LCID から STR にある各文字についての型情報を取り出します。 要求される TYPE は以下の三つのレベルのいずれかにすることができます:

        CT_CTYPE1               ANSI C and POSIX type information
        CT_CTYPE2               Text layout type information
        CT_CTYPE3               Text processing type information
        CT_CTYPE1               ANSI C と POSIX 型情報
        CT_CTYPE2               テキストレイアウト型情報
        CT_CTYPE3               テキスト処理型情報

The return value is a list of values, each of wich is a bitwise OR of the applicable type bits from the corresponding table below:

戻り値は、下記の対応テーブルからの適応できるタイプビットの OR による 値のリストです:

        @ct = GetStringType(LOCALE_SYSTEM_DEFAULT, CT_CTYPE1, "String");

ANSI C and POSIX character type information:

ANSI C と POSIX 文字型情報:

        C1_UPPER                Uppercase
        C1_LOWER                Lowercase
        C1_DIGIT                Decimal digits
        C1_SPACE                Space characters
        C1_PUNCT                Punctuation
        C1_CNTRL                Control characters
        C1_BLANK                Blank characters
        C1_XDIGIT               Hexadecimal digits
        C1_ALPHA                Any letter
        C1_UPPER                大文字
        C1_LOWER                小文字
        C1_DIGIT                数字
        C1_SPACE                空白文字
        C1_PUNCT                句読点
        C1_CNTRL                制御文字
        C1_BLANK                未定義文字
        C1_XDIGIT               16 進文字
        C1_ALPHA                任意の文字

Text layout type information:

テキストレイアウト型情報:

        C2_LEFTTORIGHT          左から右
        C2_RIGHTTOLEFT          右から左
        C2_EUROPENUMBER         ヨーロッパの数字
        C2_EUROPESEPARATOR      ヨーロッパの桁区切り記号
        C2_EUROPETERMINATOR     ヨーロッパの数字終端記号
        C2_ARABICNUMBER         アラビア数字
        C2_COMMONSEPARATOR      共通桁区切り記号
        C2_BLOCKSEPARATOR       ブロック区切り記号
        C2_SEGMENTSEPARATOR     セグメント区切り記号
        C2_WHITESPACE           空白
        C2_OTHERNEUTRAL         その他の中間文字種
        C2_NOTAPPLICABLE        暗黙的な方向のない文字(制御コードなど)

Text precessing type information:

テキスト処理型情報:

        C3_NONSPACING           非スペース文字
        C3_DIACRITIC            分音符
        C3_VOWELMARK            母音字
        C3_SYMBOL               シンボル文字
        C3_KATAKANA             カタカナ
        C3_HIRAGANA             ひらがな
        C3_HALFWIDTH            半角文字
        C3_FULLWIDTH            全角文字
        C3_IDEOGRAPH            表意文字
        C3_ALPHA                任意の文字
        C3_NOTAPPLICABLE        適用されない文字
GetSystemDefaultLangID()

Returns the system default language identifier.

システムのデフォルト言語識別子を返します。

GetSystemDefaultLCID()

Returns the system default locale identifier.

システムのデフォルトロケール識別子を返します。

GetUserDefaultLangID()

Returns the user default language identifier.

ユーザのデフォルト言語識別子を返します。

GetUserDefaultLCID()

Returns the user default locale identifier.

ユーザのデフォルト言語識別子を返します。

SendSettingChange()

Sends a WM_SETTINGCHANGE message to all top level windows.

すべてのトップレベルウィンドウに WM_SETTINGCHANGE メッセージを送ります。

SetLocaleInfo(LCID, LCTYPE, LCDATA)

Changes an item in the user override part of the locale setting LCID. It doesn't change the system default database. The following LCTYPEs are changeable:

ロケール設定 LCID のユーザ上書き部分での要素を変更します。 システムデフォルトデータベースは変更しません。 以下の LCTYPE が変更可能です:

        LOCALE_ICALENDARTYPE    LOCALE_SDATE
        LOCALE_ICURRDIGITS      LOCALE_SDECIMAL
        LOCALE_ICURRENCY        LOCALE_SGROUPING
        LOCALE_IDIGITS          LOCALE_SLIST
        LOCALE_IFIRSTDAYOFWEEK  LOCALE_SLONGDATE
        LOCALE_IFIRSTWEEKOFYEAR LOCALE_SMONDECIMALSEP
        LOCALE_ILZERO           LOCALE_SMONGROUPING
        LOCALE_IMEASURE         LOCALE_SMONTHOUSANDSEP
        LOCALE_INEGCURR         LOCALE_SNEGATIVESIGN
        LOCALE_INEGNUMBER       LOCALE_SPOSITIVESIGN
        LOCALE_IPAPERSIZE       LOCALE_SSHORTDATE
        LOCALE_ITIME            LOCALE_STHOUSAND
        LOCALE_S1159            LOCALE_STIME
        LOCALE_S2359            LOCALE_STIMEFORMAT
        LOCALE_SCURRENCY        LOCALE_SYEARMONTH

You have to call SendSettingChange() to activate these changes for subsequent Win32::OLE::Variant object formatting because the OLE subsystem seems to cache locale information.

サブシステムはロケール情報をキャッシュしているようなので、後の Win32::OLE::Variant オブジェクトの書式設定のために、これらの変更を 有効にするためには SendSettingChange() を呼び出さなければなりません。

MAKELANGID(LANG,SUBLANG)

Creates a lnguage identifier from a primary language and a sublanguage.

プライマリ言語とサブ言語から言語識別子を作成します。

PRIMARYLANGID(LANGID)

Retrieves the primary language from a language identifier.

言語識別子からプライマリ言語を取り出します。

SUBLANGID(LANGID)

Retrieves the sublanguage from a language identifier.

言語識別子からサブ言語を取り出します。

MAKELCID(LANGID)

Creates a locale identifies from a language identifier.

言語識別子からロケール識別子を作成します。

LANGIDFROMLCID(LCID)

Retrieves a language identifier from a locale identifier.

ロケール識別子から言語識別子を取り出します。

ロケールタイプ

LOCALE_ILANGUAGE

The language identifier (in hex).

言語識別子 (16 進数)。

LOCALE_SLANGUAGE

The localized name of the language.

ローカライズされた言語名。

LOCALE_SENGLANGUAGE

The ISO Standard 639 English name of the language.

言語の ISO 標準 639 英語名。

LOCALE_SABBREVLANGNAME

The three-letter abbreviated name of the language. The first two letters are from the ISO Standard 639 language name abbreviation. The third letter indicates the sublanguage type.

言語名の 3 文字の省略形。 ISO 標準 639 の 2 文字の言語簡略名を使用します。 3 番目の文字はサブ言語タイプを示します。

LOCALE_SNATIVELANGNAME

The native name of the language.

言語のネイティブな名前。

LOCALE_ICOUNTRY

The country code, which is based on international phone codes.

国際電話コードをベースとした国コード。

LOCALE_SCOUNTRY

The localized name of the country.

国のローカライズドされた名前。

LOCALE_SENGCOUNTRY

The English name of the country.

国の英語名。

LOCALE_SABBREVCTRYNAME

The ISO Standard 3166 abbreviated name of the country.

国のISO 標準 3166 省略名。

LOCALE_SNATIVECTRYNAME

The native name of the country.

国のネイティブな名前。

LOCALE_IDEFAULTLANGUAGE

Language identifier for the principal language spoken in this locale.

このロケールで話されている主要な言語のための言語識別子。

LOCALE_IDEFAULTCOUNTRY

Country code for the principal country in this locale.

このロケールでの主要な国のための国コード。

LOCALE_IDEFAULTANSICODEPAGE

The ANSI code page associated with this locale. Format: 4 Unicode decimal digits plus a Unicode null terminator.

このロケールに関連付けられたANSIコードページ。 書式: 4 Unicode 数字 プラス Unicode null 終端子。

XXX This should be translated by GetLocaleInfo. XXX

XXX これはGetLocaleInofoによって変換されるべきです XXX

LOCALE_IDEFAULTCODEPAGE

The OEM code page associated with the country.

国に関連付けれられた OEM コードページ。

LOCALE_SLIST

Characters used to separate list items (often a comma).

リスト要素を区切るために使われる文字(よくカンマが使われる)。

LOCALE_IMEASURE

Default measurement system:

デフォルトの計測方式:

        0       metric system (S.I.)
        1       U.S. system
        0       メートル式 (SI 単位)
        1       アメリカ式
LOCALE_SDECIMAL

Characters used for the decimal separator (often a dot).

小数点のための文字(よくピリオド点が使われる)。

LOCALE_STHOUSAND

Characters used as the separator between groups of digits left of the decimal.

数値の左側の数字のグループの間を区切るために使われる文字(桁区切り文字)。

LOCALE_SGROUPING

Sizes for each group of digits to the left of the decimal. An explicit size is required for each group. Sizes are separated by semicolons. If the last value is 0, the preceding value is repeated. To group thousands, specify 3;0.

数字の左側の数字のグループの大きさ(区切る桁数)。 各グループのために明確な大きさが必要とされます。 大きさはセミコロンで区切られます。 もし最後の値が 0 であれば、前の値が繰り返されます。 1000 単位でグループにするには、3;0 を指定してください。

LOCALE_IDIGITS

The number of fractional digits.

小数点以下の桁数。

LOCALE_ILZERO

Whether to use leading zeros in decimal fields. A setting of 0 means use no leading zeros; 1 means use leading zeros.

10 進数のフィールドで前に 0 をつけるかどうか。 0 を設定すると 0 はつきません; 1 は 0 をつけます。

LOCALE_SNATIVEDIGITS

The ten characters that are the native equivalent of the ASCII 0-9.

ASCII の 0-9 と等価なネイティブ 10 文字。

LOCALE_INEGNUMBER

Negative number mode.

負の数値のモード。

        0       (1.1)
        1       -1.1
        2       -1.1
        3       1.1
        4       1.1
LOCALE_SCURRENCY

The string used as the local monetary symbol.

ローカルな通貨記号として使われる文字列。

LOCALE_SINTLSYMBOL

Three characters of the International monetary symbol specified in ISO 4217, Codes for the Representation of Currencies and Funds, followed by the character separating this string from the amount.

3 文字は ISO 4217 Codes for the Representation of Currency and Funds で 指定された国際通貨記号; その後にこの文字列と数量を区切る文字がつきます。

LOCALE_SMONDECIMALSEP

Characters used for the monetary decimal separators.

通貨での小数を区切るために使われる文字。

LOCALE_SMONTHOUSANDSEP

Characters used as monetary separator between groups of digits left of the decimal.

通貨での数字の桁を区切るために使われる文字。

LOCALE_SMONGROUPING

Sizes for each group of monetary digits to the left of the decimal. An explicit size is needed for each group. Sizes are separated by semicolons. If the last value is 0, the preceding value is repeated. To group thousands, specify 3;0.

通貨での数字の桁を区切る桁数。 各グループのために明確な大きさが必要とされます。 大きさはセミコロンで区切られます。 もし最後の値が 0 であれば、前の値が繰り返されます。 1000 単位でグループにするには、3;0 を指定してください。

LOCALE_ICURRDIGITS

Number of fractional digits for the local monetary format.

ローカルな通貨フォーマットのための小数点以下の桁数。

LOCALE_IINTLCURRDIGITS

Number of fractional digits for the international monetary format.

国際通貨フォーマットのための小数点以下の桁数。

LOCALE_ICURRENCY

Positive currency mode.

正の通貨モード。

        0       Prefix, no separation.
        1       Suffix, no separation.
        2       Prefix, 1-character separation.
        3       Suffix, 1-character separation.
        0       前に付ける、区切りなし
        1       後ろに付ける、区切りなし
        2       前に付ける、1 文字の区切り
        3       後ろに付ける、1 文字の区切り
LOCALE_INEGCURR

Negative currency mode.

負の通貨モード。

        0       ($1.1)
        1       -$1.1
        2       $-1.1
        3       $1.1-
        4       $(1.1$)
        5       -1.1$
        6       1.1-$
        7       1.1$-
        8       -1.1 $ (space before $)
        9       -$ 1.1 (space after $)
        10      1.1 $- (space before $)
        0       ($1.1)
        1       -$1.1
        2       $-1.1
        3       $1.1-
        4       $(1.1$)
        5       -1.1$
        6       1.1-$
        7       1.1$-
        8       -1.1 $ ($ の前に空白)
        9       -$ 1.1 ($ の後に空白)
        10      1.1 $- ($ の前に空白)
LOCALE_ICALENDARTYPE

The type of calendar currently in use.

現在使われているカレンダーの種類。

        1       Gregorian (as in U.S.)
        2       Gregorian (always English strings)
        3       Era: Year of the Emperor (Japan)
        4       Era: Year of the Republic of China
        5       Tangun Era (Korea)
        1       グレゴリオ歴 (アメリカでのような)
        2       グレゴリオ歴 (常に英語の文字列)
        3       元号: (日本)
        4       元号: 中華民国
        5       檀紀 (朝鮮)
LOCALE_IOPTIONALCALENDAR

The additional calendar types available for this LCID. Can be a null-separated list of all valid optional calendars. Value is 0 for "None available" or any of the LOCALE_ICALENDARTYPE settings.

この LCID で利用できる追加のカレンダーの種類。 ヌルで区切ってオプションのカレンダがすべて入ったリストにすることができます。 何もなければ値は 0、あるいは LOCALE_ICALENDARTYPE 文字列のいずれか。

XXX null separated list should be translated by GetLocaleInfo XXX

XXX ヌル区切りのリストはGetLocaleInfoで変換されるべき XXX

LOCALE_SDATE

Characters used for the date separator.

日付区切りに使われる文字。

LOCALE_STIME

Characters used for the time separator.

時刻区切りに使われる文字。

LOCALE_STIMEFORMAT

Time-formatting string.

時刻書式設定文字列。

LOCALE_SSHORTDATE

Short Date_Time formatting strings for this locale.

このロケールでの短い日付時刻書式設定文字列。

LOCALE_SLONGDATE

Long Date_Time formatting strings for this locale.

このロケールでの長い日付時刻書式設定文字列。

LOCALE_IDATE

Short Date format-ordering specifier.

短い長い日付書式の順序指定子。

        0       Month - Day - Year
        1       Day - Month - Year
        2       Year - Month - Day
        0       月 - 日 - 年
        1       日 - 月 - 年
        2       年 - 月 - 日
LOCALE_ILDATE

Long Date format ordering specifier. Value can be any of the valid LOCALE_IDATE settings.

長い日付書式の順序指定子。 LOCALE_IDATE 設定のための適切な値のいずれにもすることができます。

LOCALE_ITIME

Time format specifier.

時刻書式設定指定子。

        0       AM/PM 12-hour format.
        1       24-hour format.
        0       AM/PM 12 時間形式。
        1       24 時間形式。
LOCALE_ITIMEMARKPOSN

Whether the time marker string (AM|PM) precedes or follows the time string.

時刻マーカー文字列 (AM|PM) が時刻文字列の前につくか後につくか。

        0 Suffix (9:15 AM).
        1 Prefix (AM 9:15).
        0 後ろにつく (9:15 AM).
        1 前に付く (AM 9:15).
LOCALE_ICENTURY

Whether to use full 4-digit century.

全 4 桁の年を使うかどうか。

        0       Two digit.
        1       Full century.
        0       2 桁。
        1       年全体。
LOCALE_ITLZERO

Whether to use leading zeros in time fields.

時刻フィールドで 0 が前につくかどうか。

        0       No leading zeros.
        1       Leading zeros for hours.
        0       前に 0 を付けません。
        1       時フィールドの前に 0 を付けます。
LOCALE_IDAYLZERO

Whether to use leading zeros in day fields. Values as for LOCALE_ITLZERO.

日のフィールドで 0 をつけるかどうか。 値は LOCALE_ITLZERO と同じ。

LOCALE_IMONLZERO

Whether to use leading zeros in month fields. Values as for LOCALE_ITLZERO.

月のフィールドで 0 をつけるかどうか。 値は LOCALE_ITLZERO と同じ。

LOCALE_S1159

String for the AM designator.

午前を表すための文字列。

LOCALE_S2359

String for the PM designator.

午後を表すための文字列。

LOCALE_IFIRSTWEEKOFYEAR

Specifies which week of the year is considered first.

その年のどの週を最初と考えるかを指定します。

        0       Week containing 1/1 is the first week of the year.
        1       First full week following 1/1is the first week of the year.
        2       First week with at least 4 days is the first week of the year.
        0       1/1 が含まれる週をその年の最初の週とします。
        1       1/1 の後の完全な 1 週間をその年の最初の週とします。
        2       少なくとも 4 日ある最初の週をその年の最初の週とします。
LOCALE_IFIRSTDAYOFWEEK

Specifies the day considered first in the week. Value "0" means SDAYNAME1 and value "6" means SDAYNAME7.

週の最初の日と考えられる日を指定します。 値 "0" は SDAYNAME1 そして値 "6" は SDAYNAME7 を意味します。

LOCALE_SDAYNAME1 .. LOCALE_SDAYNAME7

Long name for Monday .. Sunday.

月曜日から日曜日のための長い名前。

LOCALE_SABBREVDAYNAME1 .. LOCALE_SABBREVDAYNAME7

Abbreviated name for Monday .. Sunday.

月曜日から日曜日のための省略名。

LOCALE_SMONTHNAME1 .. LOCALE_SMONTHNAME12

Long name for January .. December.

1 月から 12 月のための長い名前。

LOCALE_SMONTHNAME13

Native name for 13th month, if it exists.

もしあれば 13 番目の月のネイティブな名前。

LOCALE_SABBREVMONTHNAME1 .. LOCALE_SABBREVMONTHNAME12

Abbreviated name for January .. December.

1 月から 12 月のための省略名。

LOCALE_SABBREVMONTHNAME13

Native abbreviated name for 13th month, if it exists.

もしあれば 13 番目の月のネイティブな省略名。

LOCALE_SPOSITIVESIGN

String value for the positive sign.

正の記号のための文字列。

LOCALE_SNEGATIVESIGN

String value for the negative sign.

負の記号のための文字列。

LOCALE_IPOSSIGNPOSN

Formatting index for positive values.

正の値のための書式インデックス。

        0 Parentheses surround the amount and the monetary symbol.
        1 The sign string precedes the amount and the monetary symbol.
        2 The sign string precedes the amount and the monetary symbol.
        3 The sign string precedes the amount and the monetary symbol.
        4 The sign string precedes the amount and the monetary symbol.
        0 通貨記号も含めた全体を括弧で囲みます。
        1 符号文字列を全体と通貨記号の前につけます。
        2 符号文字列を全体と通貨記号の後につけます。
        3 符号文字列を通貨記号の前につけます。
        4 符号文字列を通貨記号の後につけます。
LOCALE_INEGSIGNPOSN

Formatting index for negative values. Values as for LOCALE_IPOSSIGNPOSN.

負の値のための書式インデックス。 値は LOCALE_IPOSSIGNPOSN と同じ。

LOCALE_IPOSSYMPRECEDES

If the monetary symbol precedes, 1. If it succeeds a positive amount, 0.

もし通貨記号が前につくのであれば 1。 それが正の数値の後に続くのであれば 0。

LOCALE_IPOSSEPBYSPACE

If the monetary symbol is separated by a space from a positive amount, 1. Otherwise, 0.

正の数値から空白によって区切られるのであれば 1。 そうでなければ 0。

LOCALE_INEGSYMPRECEDES

If the monetary symbol precedes, 1. If it succeeds a negative amount, 0.

もし通貨記号が前につくのであれば 1。 それが負の数値の後に続くのであれば 0。

LOCALE_INEGSEPBYSPACE

If the monetary symbol is separated by a space from a negative amount, 1. Otherwise, 0.

負の数値から空白によって区切られるのであれば 1。 そうでなければ 0。

AUTHORS/COPYRIGHT

This module is part of the Win32::OLE distribution.

このモジュールは Win32::OLE ディストリビューションの一部です。