FileSetAttrib

1つまたは複数のファイルまたはフォルダーの属性を変更します。ワイルドカードに対応しています。

FileSetAttrib Attributes , FilePattern, Mode

パラメータ

Attributes

型：文字列

変えるべき属性。For example, "+HA-R".

To easily turn on, turn off or toggle attributes, prefix one or more of the following attribute letters with a plus (+), minus (-) or caret (^) symbol, respectively:

• R = READONLY
• A = ARCHIVE
• S = SYSTEM
• H = HIDDEN
• N = NORMAL（他の属性を使用しない場合にのみ有効です）
• O = OFFLINE
• T = TEMPORARY

If no symbol precedes the attribute letters, the file's attributes are replaced with the given attributes. See example #5. To remove all attributes, use "N" on its own.

FilePattern

型：文字列

省略されたときは、最も内側のファイルループの中の現在のファイルが設定されます。それ以外の場合、単一のファイルまたはフォルダの名前、または"C:\Temp\*.tmp"のようなワイルドカードパターンです。絶対パスが指定されない場合、FilePatternはA_WorkingDir にあるとみなされます。

アスタリスク（*）とクエスチョンマーク（?）は、ワイルドカードとして使用できます。*は0以上の文字と、クエスチョンマークは?1文字とマッチします。使用例：

• *.*と*は、全てのファイルにマッチします。
• *.htmは、.htmや.htmlなどの拡張子を持つファイルにマッチします。
• *.は、拡張子がないファイルにマッチします。
• log?.txtは、例えばlog1.txtにはマッチしますが、log10.txtにはマッチしません。
• *report*は、ファイル名に"report"を含むあらゆるファイルにマッチします。

Mode

型：文字列

空白または省略された場合、ファイルのみが操作され、サブディレクトリは再帰されません。それ以外の場合は、以下の文字を1つ以上指定してください：

• D = インクルードディレクトリ（フォルダ）。
• F = インクルードファイル。FとDの両方が省略された場合、ファイルは含まれるがフォルダーは含まれません。
• R = サブフォルダを再帰的に検索し、FilePatternに一致するファイルおよびフォルダを操作します。FilePatternに一致する名前のサブフォルダだけでなく、すべてのサブフォルダに再帰的にアクセスします。Rが省略された場合、サブフォルダー内のファイルやフォルダーは含まれません。

エラー処理

ファイルの変更に失敗した場合、ErrorがThrowされ、Extraプロパティには失敗した回数が設定されます。

ファイルが見つかった場合、A_LastErrorには0（ゼロ）または最後の失敗の直後のオペレーティングシステムのGetLastError()関数の結果が設定されます。それ以外の場合、A_LastError は、ファイルが見つからなかった理由を示す可能性のあるエラーコードを含みます。

備考

この機能でファイルの圧縮状態を変更することはできません。

関連

FileGetAttrib、FileGetTime、FileSetTime、FileGetSize、FileGetVersion、ファイルループ

例

FileSetAttrib "+RH", "C:\MyFiles\*.*", "DF"  ; +RHは、+R+Hと同じです。

FileSetAttrib "^H", "C:\MyFiles"

FileSetAttrib "-R+A", "C:\New Text File.txt"

FileSetAttrib "+A", "C:\*.ini", "R"

FileSetAttrib(FileGetAttrib(file2), file1)